# Live today — this is the shipped endpoint.
curl -X POST https://api.runner.dev/v1/scrape \
  -H "Authorization: Bearer $RUNNER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/pricing",
    "country": "US",
    "formats": ["markdown", "links"]
  }'

# => { "success": true, "data": { "markdown": "...", "links": [...] },
#      "credits": { "charged": 2.4, "balance": 97.6 } }

Planned. This client is not published yet. The HTTP API tab works today and every planned client will call the same endpoint.

import { Runner } from '@runner/client';

// One API key authenticates every request.
const runner = new Runner({ apiKey: process.env.RUNNER_API_KEY });

// Fetch a page through a residential IP, returned as Markdown.
const { markdown } = await runner.scrape({
  url: 'https://example.com/pricing',
  geo: 'US',
  format: 'markdown',
});

console.log(markdown);

Planned. This client is not published yet. The HTTP API tab works today and every planned client will call the same endpoint.

import { Runner } from '@runner/client';

const runner = new Runner({ apiKey: process.env.RUNNER_API_KEY });

// Headless render for JS-heavy pages and SPAs.
const { html } = await runner.scrape({
  url: 'https://app.example.com/feed',
  render: true,
  waitFor: 'networkidle',
});

console.log(html);

Planned. This client is not published yet. The HTTP API tab works today and every planned client will call the same endpoint.

import { Runner } from '@runner/client';
import { z } from 'zod';

const runner = new Runner({ apiKey: process.env.RUNNER_API_KEY });

// Scrape + LLM extraction into your schema.
const { data } = await runner.extract({
  url: 'https://store.example.com/item/42',
  schema: z.object({
    title: z.string(),
    price: z.number(),
    inStock: z.boolean(),
  }),
});

console.log(data); // { title, price, inStock }

Planned. This client is not published yet. The HTTP API tab works today and every planned client will call the same endpoint.

import { Runner } from '@runner/client';

const runner = new Runner({ apiKey: process.env.RUNNER_API_KEY });

// Route any request through a real residential IP, anywhere.
const res = await runner.proxy.fetch('https://example.com', {
  country: 'US',
});

console.log(res.status, await res.text());