Skip to main content
Reader provides first-party SDKs that wrap POST /v1/read, handle async job polling, parse the envelope contract, and throw typed errors.

Available SDKs

Quick comparison

Both SDKs return a discriminated result: kind: "scrape" for single-URL requests, kind: "job" for batches and crawls. The SDK auto-polls async jobs to completion and collects all paginated results before returning.

Features

Error handling

Errors from the API are parsed into specific exception subclasses so you can branch on the error type rather than HTTP status:
The full catalog of 11 error codes is documented on the Errors page.

Next