scrape

const result = await saturn.scrape({
  url: 'https://example.com/products',
});

console.log(result.data.html);
// → Raw HTML content

interface ScrapeResponse {
  data: {
    html: string;       // Raw HTML content
    url: string;        // Final URL (after redirects)
    statusCode: number; // HTTP status code
  };
  metadata: {
    chargedUsdCents: number;
    provider: string;
    latencyMs: number;
    auditId: string;
  };
}

const page = await saturn.scrape({
  url: 'https://store.example.com/product/123',
});

// Use LLM to extract structured data
const extraction = await saturn.reason({
  prompt: `Extract product information from this HTML as JSON:
  - name
  - price
  - description
  - availability

  HTML:
  ${page.data.html}`,
});

const product = JSON.parse(extraction.data.content);

// Wait for JavaScript to render
const page = await saturn.scrape({
  url: 'https://spa.example.com',
  waitFor: 3000, // Wait 3 seconds
});

async function extractJobListings(url: string) {
  const page = await saturn.scrape({ url });

  const jobs = await saturn.reason({
    prompt: `Extract job listings from this HTML as JSON array:
    Each job should have: title, company, location, salary (if listed)

    HTML:
    ${page.data.html}`,
  });

  return JSON.parse(jobs.data.content);
}