BNCA API Documentation

{
  "url": "https://example.com",     // Required: URL to scrape
  "screenshot": false,             // Optional: Include screenshot
  "question": "What is this about?" // Optional: AI question to answer
}

// Using fetch
const response = await fetch('https://bnca-api.fly.dev/quickshot', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'your-api-key'
  },
  body: JSON.stringify({ url: 'https://example.com' })
});

const result = await response.json();
console.log('Screenshot:', result.screenshot); // Base64 image

{
  "success": true,
  "data": {
    "title": "Page Title",
    "content": "Main content...",
    "description": "Meta description",
    "headings": [...],
    "links": [...],
    "structuredData": {...}
  },
  "metadata": {
    "method": "lightpanda",        // Method that succeeded
    "timestamp": "2024-01-01T...",
    "responseTime": 1234
  },
  "screenshot": "data:image/png;base64,..." // If requested
}

const screenshot = await scraper.screenshot('https://example.com', {
  width: 1920,
  height: 1080,
  fullPage: true,
  quality: 90,
  format: 'png'    // 'png' or 'jpeg'
});

if (screenshot.success) {
  console.log('Screenshot saved to:', screenshot.path);
  console.log('Size:', screenshot.size, 'bytes');
}

const result = await scraper.askAI(
  'https://example.com', 
  'What is this website about?'
);

if (result.success) {
  console.log('Answer:', result.answer);
  console.log('Scrape method used:', result.method);
  console.log('Processing time:', result.scrapeTime, 'ms');
}

// Use backend API for better AI responses
const scraper = new BNCASmartScraper({
  apiKey: 'your-api-key',
  apiUrl: 'https://bnca-api.fly.dev'
});

const result = await scraper.askAI(
  'https://news.site.com',
  'What are the top 3 headlines?'
);

// Check if all components are working
const health = await scraper.healthCheck();
console.log('Lightpanda available:', health.lightpanda);
console.log('Puppeteer available:', health.puppeteer);

// Clean up browser instances and resources
await scraper.cleanup();

// Get performance statistics
const stats = scraper.getStats();
console.log('Success rates:', stats);

import { smartScrape } from '@monostate/node-scraper';

// One-off scraping without class instantiation
const result = await smartScrape('https://example.com', {
  timeout: 5000,
  verbose: true
});

import { smartScreenshot, quickShot } from '@monostate/node-scraper';

// High-quality screenshot
const screenshot = await smartScreenshot('https://example.com');

// Fast screenshot for previews
const preview = await quickShot('https://example.com', {
  width: 800,
  height: 600
});

import { askWebsiteAI } from '@monostate/node-scraper';

// Ask AI about a webpage
const result = await askWebsiteAI(
  'https://example.com',
  'What services does this company offer?',
  { apiKey: 'your-api-key' }
);

console.log('Answer:', result.answer);

{
  "url": "https://example.com",    // Required: URL to scrape
  "screenshot": false              // Optional: Take screenshot (default: false)
}

{
  "success": true,
  "data": {
    "title": "Example Domain",
    "content": "This domain is for use in illustrative examples...",
    "metaDescription": "Example description",
    "links": [
      {
        "text": "More information...",
        "href": "https://www.iana.org/domains/example"
      }
    ],
    "images": [
      {
        "src": "https://example.com/image.jpg",
        "alt": "Example image"
      }
    ],
    "structuredData": { /* JSON-LD data if found */ }
  },
  "metadata": {
    "url": "https://example.com",
    "method": "direct",              // direct | lightpanda | puppeteer
    "timestamp": "2024-01-01T00:00:00.000Z",
    "performance": {
      "totalTime": 1234
    },
    "screenshot": null              // Base64 image if requested
  }
}

const response = await fetch('https://api.bnca.monostate.ai/scrapeurl', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://news.ycombinator.com',
    screenshot: true
  })
});

const result = await response.json();
console.log('Page title:', result.data.title);
console.log('Extraction method:', result.metadata.method);

{
  "url": "https://example.com",           // Required: URL to analyze
  "question": "What is this page about?", // Required: Question to ask
  "screenshot": false                     // Optional: Take screenshot
}

{
  "success": true,
  "answer": "This page is about domain examples used in documentation...",
  "metadata": {
    "url": "https://example.com",
    "question": "What is this page about?",
    "method": "direct",
    "timestamp": "2024-01-01T00:00:00.000Z",
    "performance": {
      "totalTime": 2345,
      "scrapeTime": 1234,
      "processingTime": 1111
    },
    "screenshot": null
  }
}

const response = await fetch('https://api.bnca.monostate.ai/aireply', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://techcrunch.com/2024/01/01/some-article',
    question: 'What are the main points of this article?'
  })
});

const result = await response.json();
console.log('AI Answer:', result.answer);