API Documentation

Authentication

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

Get your API key: API Key Documentation

All API responses include rate limit headers (x-ratelimit-limit, x-ratelimit-used, x-ratelimit-remaining). See Rate Limiting for details.

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"
    },
    "config": {
      "pdfWidthMm": 210,
      "pdfHeightMm": 297
    }
  }
}

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
      },
      "config": {
        "pdfWidthMm": 150,
        "pdfHeightMm": 150
      }
    }
  }' \
  > 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');

HTML Pages API

The HTML Pages API allows you to host, deploy, and manage HTML pages. You can create, update, retrieve, and delete HTML pages using a different base domain.

Base URL: https://api.app.customjs.io

POST /pages/page/upsert-html

https://api.app.customjs.io/pages/page/upsert-html

Create or update an HTML page. If a page with the specified name already exists, it will be updated; otherwise, a new page will be created.

Headers

Request Body

{
  "name": "my-landing-page",
  "htmlContent": "<!DOCTYPE html><html><head><title>My Page</title></head><body><h1>Hello World</h1></body></html>",
  "slug": "custom-url-slug"
}

Parameters

Example Request

curl -X POST 'https://api.app.customjs.io/pages/page/upsert-html' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "my-landing-page",
    "htmlContent": "<!DOCTYPE html><html><head><title>My Page</title></head><body><h1>Hello World</h1></body></html>",
    "slug": "my-custom-page"
  }'

Response

Content-Type: application/json

{
  "pageId": "abc123",
  "htmlFileUrl": "https://...",
  "name": "my-landing-page",
  "message": "Page created successfully",
  "created": true
}

GET /pages/api/page

https://api.app.customjs.io/pages/api/page

Retrieve all HTML pages for your workspace.

Headers

Example Request

curl -X GET 'https://api.app.customjs.io/pages/api/page' \
  -H 'x-api-key: YOUR_API_KEY'

Response

Content-Type: application/json

Returns an array of page objects.

GET /pages/api/page/id/{pageId}

https://api.app.customjs.io/pages/api/page/id/{pageId}

Retrieve a specific HTML page by its ID.

Headers

Path Parameters

Example Request

curl -X GET 'https://api.app.customjs.io/pages/api/page/id/abc123' \
  -H 'x-api-key: YOUR_API_KEY'

Response

Content-Type: application/json

Returns the page object with full details.

DELETE /pages/api/page/id/{pageId}

https://api.app.customjs.io/pages/api/page/id/{pageId}

Delete a specific HTML page by its ID.

Headers

Path Parameters

Example Request

curl -X DELETE 'https://api.app.customjs.io/pages/api/page/id/abc123' \
  -H 'x-api-key: YOUR_API_KEY'

Response

Content-Type: application/json

Returns a success message confirming the deletion.

Rate Limiting

All API endpoints include rate limit information in the response headers:

Example Response Headers:

x-ratelimit-used: 294
x-ratelimit-remaining: 206
x-ratelimit-limit: 500

Error Responses

All APIs return standard HTTP status codes: