{"uid":"cap_7JP6gJGTCb1H1qenPxzwN","slug":"how-is-read-page-0dc5a6db","name":"how.is Read Page","description":"Read a web page as clean markdown, with a safety verdict attached: robots.txt honored for your agent, risky sites flagged as untrusted, optional screenshot.","url":"https://how.is/v1/read?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"ua":{"type":"string","maxLength":512,"description":"The user agent you will fetch with; robots.txt and our bot policy are judged for it. Defaults to the User-Agent of this request."},"url":{"type":"string","format":"uri","maxLength":2000,"description":"The http(s) page to read"},"screenshot":{"type":"boolean","description":"Also return a 1280x800 JPEG of the page"}}},"responseSchema":{"type":"json","example":{"data":{"_shape":"data: markdown, title, description, lang, canonical, final_url, http_status, content_type, words, truncated, untrusted_content, preflight{verdict, safe_to, reasons, ...}, screenshot{image_base64, ...} when asked."},"result":"Read a page (with verdict) for the requested subject","receipt":{"rail":"x402","tool":"read","charge_usd":0.005,"settlement_tx":"0x…"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dvo8Fs9tEujr8nKfZVRoe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a web page and returns it as clean markdown with a safety verdict, robots.txt compliance, and an optional screenshot","exampleAgentPrompt":"Can you fetch https://example.com/blog/article and give me the content as clean readable text, and let me know if the site is safe to access?","exampleUseCases":[{"title":"Safe news article extraction","prompt":"Read the article at https://www.bbc.com/news/technology-12345678 and give me the full text in clean markdown — and flag it if the site looks untrustworthy."},{"title":"Agent pipeline web research","prompt":"Fetch https://docs.openai.com/guides/function-calling and extract the readable content as markdown so I can summarize it — make sure you're identifying yourself as my research bot and honoring their robots.txt."},{"title":"Suspicious link content check","prompt":"Someone sent me a link to https://totally-legit-deals.net/offer — can you read what's on that page, tell me the actual content in markdown, and let me know if the safety check flags it as risky?"}],"resultDescription":"Returns a JSON object with the page's markdown body, title, description, language, canonical and final URLs, HTTP status, word count, truncation flag, an untrusted_content flag, a preflight safety verdict with reasons, and optionally a base64-encoded JPEG screenshot. Also includes a receipt confirming the x402 micropayment charge of $0.005 USDC.","failureModes":["URL not reachable or returns non-200 HTTP status","robots.txt disallows the specified user agent, returning a blocked/disallowed verdict","Malformed or invalid URL input","Page content exceeds length limits and is truncated","Screenshot unavailable for certain page types (e.g. paywalled, JS-heavy)","Safety preflight verdict returns untrusted, blocking content delivery"],"whenToPreferThis":"Choose this endpoint when you need both clean extracted page content AND a trust/safety signal in a single call — particularly when your agent must respect robots.txt, handle untrusted or phishing-risk domains, or needs a rendered screenshot alongside the text. Prefer over generic scrapers when compliance with bot policies and safety verdicts are required, such as in automated research pipelines or when processing user-submitted URLs of unknown provenance.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:39:33.812Z","isFirstParty":false,"canonicalSlug":"how-is-read-page-0dc5a6db"}