API Documentation

{
  "success": true,
  "data": {
    "image": "base64_encoded_image_data...",
    "width": 1280,
    "height": 720,
    "format": "png",
    "file_size_bytes": 284720
  },
  "meta": {
    "request_id": "req_a1b2c3d4",
    "processing_ms": 1840,
    "remaining_credits": 99
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_URL",
    "message": "The provided URL is not valid. Must be http:// or https://"
  },
  "meta": {
    "request_id": "req_a1b2c3d4",
    "processing_ms": 120
  }
}

curl -X POST https://screenshot.endpnt.dev/api/v1/capture \
  -H "x-api-key: ek_live_demo123" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "format": "png",
    "width": 1280,
    "height": 720,
    "full_page": true,
    "dark_mode": false
  }'

// Using fetch
const response = await fetch('https://screenshot.endpnt.dev/api/v1/capture', {
  method: 'POST',
  headers: {
    'x-api-key': 'your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://example.com',
    format: 'png',
    width: 1280,
    height: 720,
    full_page: true
  })
});

const result = await response.json();
if (result.success) {
  // result.data.image contains base64 image data
  const img = document.createElement('img');
  img.src = `data:image/${result.data.format};base64,${result.data.image}`;
  document.body.appendChild(img);
}

// Using Node.js with axios
const axios = require('axios');
const fs = require('fs');

async function takeScreenshot(url) {
  try {
    const response = await axios.post(
      'https://screenshot.endpnt.dev/api/v1/capture',
      {
        url: url,
        format: 'png',
        width: 1280,
        height: 720,
        full_page: true
      },
      {
        headers: {
          'x-api-key': 'your_api_key',
          'Content-Type': 'application/json'
        }
      }
    );

    if (response.data.success) {
      const imageBuffer = Buffer.from(response.data.data.image, 'base64');
      fs.writeFileSync('screenshot.png', imageBuffer);
      console.log('Screenshot saved!');
    }
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
  }
}

takeScreenshot('https://example.com');

import requests
import base64

# Make the API request
response = requests.post(
    'https://screenshot.endpnt.dev/api/v1/capture',
    headers={
        'x-api-key': 'your_api_key',
        'Content-Type': 'application/json'
    },
    json={
        'url': 'https://example.com',
        'format': 'png',
        'width': 1280,
        'height': 720,
        'full_page': True
    }
)

result = response.json()
if result['success']:
    # Decode and save the image
    image_data = base64.b64decode(result['data']['image'])
    with open('screenshot.png', 'wb') as f:
        f.write(image_data)
    print(f"Saved screenshot: {result['data']['width']}x{result['data']['height']}")