Introducing Fetch

​

Highlights

• Up to 20 URLs per call — URLs are fetched concurrently, so a batch takes about as long as its slowest page.
• Markdown by default — formats resolves to ["markdown"] when omitted, returning the page’s main content with navigation, footers and ads removed.
• Keyed by the URL you sent — Results arrive in the requested order, and requested_url is echoed back byte for byte as the correlation key. Two identical URLs in one request are rejected, because a repeated key is ambiguous.
• A failed page is not a failed call — A page that could not be fetched arrives inside the 200 with status = "error" and an error.code. Only the request is rejected with a non-200, and then nothing is fetched and nothing is billed.
• Per-URL time budget — timeout_ms applies to one URL, not to the batch. 75 seconds is the maximum and the default; higher values are clamped, not rejected.
• One tier — tier selects the price. "pro" is the only value and an omitted tier resolves to it.

​

Quick Start

from seltz import FetchStatus, Seltz

client = Seltz(api_key="your-api-key")

response = client.fetch(["https://example.com/"])

for result in response.results:
    if result.status == FetchStatus.FETCH_STATUS_OK:
        print(result.markdown)

import { FetchStatus, Seltz } from "seltz";

const client = new Seltz({ apiKey: "your-api-key" });

const response = await client.fetch({ urls: ["https://example.com/"] });

for (const result of response.results) {
  if (result.status === FetchStatus.OK) {
    console.log(result.markdown);
  }
}

curl -X POST https://api.seltz.ai/v1/fetch \
  -H "x-api-key: $SELTZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://example.com/"]}'

​

Good to Know