API Documentation

Authentication

All API requests require authentication via the x-api-key header.

Get your API key: API Key Documentation

Available Endpoints

PDF Generator API

POST /html2pdf

https://e.customjs.io/html2pdf

Converts HTML to PDF with optional template rendering using Nunjucks.

Headers

Request Body

{
  "input": {
    "html": "<h1>Hello {{ name }}</h1>",
    "data": {
      "name": "World"
    }
  }
}

Parameters

Example Request

Simple HTML:

curl -X POST 'https://e.customjs.io/html2pdf' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "input": {
      "html": "<h1>Hello World</h1>"
    }
  }' \
  > output.pdf

With Template Data:

curl -X POST 'https://e.customjs.io/html2pdf' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "input": {
      "html": "<h1>Hello {{ name }}</h1><p>Total: {{ total }}</p>",
      "data": {
        "name": "John",
        "total": 100
      }
    }
  }' \
  > output.pdf

Response

Content-Type: application/pdf

Returns binary PDF data.

POST /markdown2pdf

https://e.customjs.io/markdown2pdf

Converts Markdown to PDF.

Headers

Request Body

{
  "input": {
    "markdown": "# Hello World\n\nThis is **bold** text."
  }
}

Parameters

Example Request

curl -X POST 'https://e.customjs.io/markdown2pdf' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "input": {
      "markdown": "# Hello World\n\nThis is **bold** text."
    }
  }' \
  > output.pdf

Response

Content-Type: application/pdf

Returns binary PDF data.

Screenshot API

POST /screenshot

https://e.customjs.io/screenshot

Captures a screenshot of a web page with optional automation commands and custom viewport.

Headers

Request Body

{
  "input": {
    "url": "https://example.com",
    "commands": [],
    "box": {
      "x": 0,
      "y": 0,
      "width": 1200,
      "height": 800
    }
  }
}

Parameters

Example Request

Full Page Screenshot:

curl -X POST 'https://e.customjs.io/screenshot' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "input": {
      "url": "https://example.com",
      "commands": []
    }
  }' \
  > output.png

With Automation Commands:

curl -X POST 'https://e.customjs.io/screenshot' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "input": {
      "url": "https://example.com",
      "commands": [
        {"action": "click", "selector": "#accept-cookies"},
        {"action": "wait", "value": 1000},
        {"action": "scroll", "value": 500}
      ]
    }
  }' \
  > output.png

Custom Viewport Screenshot:

curl -X POST 'https://e.customjs.io/screenshot' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "input": {
      "url": "https://example.com",
      "commands": [],
      "box": {
        "x": 0,
        "y": 0,
        "width": 1200,
        "height": 800
      }
    }
  }' \
  > output.png

Response

Content-Type: image/png

Returns binary PNG image data.

HTML Scraper API

POST /scraper

https://e.customjs.io/scraper

Scrapes HTML content from a web page with optional automation commands.

Headers

Request Body

{
  "input": {
    "url": "https://example.com",
    "commands": []
  }
}

Parameters

Example Request

Simple Scraping:

curl -X POST 'https://e.customjs.io/scraper' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "input": {
      "url": "https://example.com",
      "commands": []
    }
  }' \
  > output.html

With Automation Commands:

curl -X POST 'https://e.customjs.io/scraper' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "input": {
      "url": "https://example.com",
      "commands": [
        {"action": "click", "selector": "button.load-more"},
        {"action": "wait", "value": 2000},
        {"action": "type", "selector": "input#search", "value": "CustomJS"}
      ]
    }
  }' \
  > output.html

Response

Content-Type: text/html

Returns HTML content as text.

Automation Commands

The commands parameter accepts an array of automation actions that are executed before taking a screenshot or scraping HTML. Each command is an object with the following structure:

Available Commands

Example Command Sequence

{
  "commands": [
    {"action": "waitForSelector", "selector": "#content"},
    {"action": "click", "selector": "#accept-cookies"},
    {"action": "wait", "value": 1000},
    {"action": "type", "selector": "input#search", "value": "CustomJS"},
    {"action": "click", "selector": "button[type='submit']"},
    {"action": "wait", "value": 2000},
    {"action": "scroll", "value": 500}
  ]
}

JavaScript Execution API

POST /__js1-

https://e.customjs.io/__js1-

Execute custom JavaScript code with input data and access to available NPM modules.

Headers

Request Body

{
  "input": "{\"name\":\"Jon Doe\"}",
  "code": "return input.name"
}

Parameters

Example Request

curl -X POST 'https://e.customjs.io/__js1-' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "input": "{\"name\":\"Jon Doe\"}",
    "code": "return input.name"
  }'

Response

Returns the result of the executed JavaScript code.

Available NPM Modules

The following NPM modules are available for use in CustomJS. Contact us if you would like to use another NPM module.

const cheerio = require('cheerio');
const { v4: uuidv4 } = require('uuid');
const axios = require('axios').default;
const AWS = require('@aws-sdk/client-s3'); // Typically you import specific AWS services
const jsrsasign = require('jsrsasign');
const forge = require('node-forge'); // Package is typically called 'node-forge'
const { piexif } = require('piexifjs');
const jsrsasignUtil = require('jsrsasign-util');
const jsonwebtoken = require('jsonwebtoken');
const crypto = require('crypto');
const { Configuration, OpenAIApi } = require('openai');
const JavaScriptObfuscator = require('javascript-obfuscator');
const { AuthRocket } = require('@authrocket/authrocket-node');
const firebaseAdmin = require('firebase-admin');
const { PDFDocument, StandardFonts, rgb } = require('pdf-lib');
const mysql2 = require('mysql2');
const cryptoJs = require('crypto-js');
const nodemailer = require('nodemailer');
const converter = require('json-2-csv');
const htmlToText = require('html-to-text');
const moment = require('moment');
const Alexa = require('ask-sdk-core');
const jose = require('jose');
const { nanoid } = require('nanoid');
const { getJson } = require('serpapi');
const { Storage } = require('@google-cloud/storage');

Error Responses

All APIs return standard HTTP status codes: