Browser sessions

const key = process.env.MONOCRAWL_API_KEY;
if (!key) throw new Error('Set MONOCRAWL_API_KEY');
async function call(endpoint, params, requestKey) {
  const url = new URL('https://www.monocrawl.com/v1/web/' + endpoint);
  for (const [name, value] of Object.entries(params)) url.searchParams.set(name, String(value));
  const response = await fetch(url, {
    headers: { 'x-api-key': key, 'Idempotency-Key': requestKey },
    signal: AbortSignal.timeout(45_000),
  });
  const envelope = await response.json();
  if (!response.ok || !envelope.success) throw new Error(JSON.stringify({
    request_id: envelope.request_id, error: envelope.error, credits_used: envelope.credits_used,
  }));
  return envelope;
}
// Check current prices and use a capped key before running this paid example.
// Persist a unique key BEFORE each call. Reuse it only to recover that same call.
const created = await call('sessions/create',
  { url: 'https://example.com', ttl_seconds: 60 }, 'REPLACE_WITH_SAVED_CREATE_KEY');
const sessionId = created.data.session_id; // Persist immediately for recovery.
try {
  if (created.credits_used == null) throw new Error('Reconcile creation billing before more paid work');
  const result = await call('sessions/execute', {
    session_id: sessionId, language: 'javascript', timeout: 10_000,
    code: '({ title: document.title, url: location.href })',
  }, 'REPLACE_WITH_SAVED_EXECUTE_KEY');
  if (!result.data.success) throw new Error(result.data.error || 'Page execution failed');
  if (result.credits_used == null) throw new Error('Reconcile execution billing');
  console.log(result.data.result); // Keep the full envelope for its receipt.
} finally {
  await call('sessions/close', { session_id: sessionId }, 'REPLACE_WITH_SAVED_CLOSE_KEY');
}