easybits-extractor

n8n node that extracts binary files and converts them to base64 Data URLs

Package Information

Downloads: 22 weekly / 531 monthly
Latest Version: 0.3.0
Author: Ivan Afonchenko

Documentation

n8n-nodes-easybits-extractor

npm version
License: MIT

n8n community node that sends documents to the Easybits Extractor API for structured data extraction.

What it does

Easybits Extractor lets you create extraction pipelines that pull structured data from documents. This n8n node connects your workflows to those pipelines:

  1. Create a pipeline at extractor.easybits.tech
  2. Use this node in n8n to send PDF, JPG, or PNG files to your pipeline
  3. Get structured JSON back in your workflow

Installation

Follow the n8n community nodes installation guide.

The package name is: n8n-nodes-easybits-extractor

Supported file formats

JPEG, PNG, and PDF — other file types will be rejected with a clear error message.

Configuration

Parameter Description
Pipeline ID The ID of your extraction pipeline, obtained from Easybits Extractor
API Key Your API key from the Easybits Extractor dashboard (stored as a secret)
Input Type How files are provided: Binary Files (default), Data URLs, or Auto (Both)
Data URL Field JSON field name containing base64 Data URL(s). Shown when Input Type is Data URLs or Auto. Default: dataUrl

Input types

  • Binary Files — reads binary attachments from input items (e.g. from Read Binary File, HTTP Request, or email trigger nodes). This is the default and matches the original behavior.
  • Data URLs — reads pre-encoded base64 Data URLs from a JSON field on each item. Useful when you already have Data URLs from a previous API response or a Set node.
  • Auto (Both) — collects both binary attachments and Data URLs from the same items. Handy when mixing sources.

How it works

  1. Collects files from all input items (as binary attachments, Data URLs, or both — depending on Input Type)
  2. Converts binary files to base64 Data URLs; passes Data URLs through as-is
  3. POSTs them all to https://extractor.easybits.tech/api/pipelines/{pipelineId} with Bearer auth
  4. Returns the extraction result as a single JSON output item

Recipes

Extract data from a single file

Use Read Binary File to load a document, then connect it to easybits Extractor.

[Read Binary File] → [easybits Extractor]

Extractor settings:

  • Input Type: Binary Files
  • Pipeline ID: your pipeline ID
  • API Key: your API key

Extract data from multiple files

Any node that outputs multiple items with binary attachments works — for example, reading files from disk in a loop, or an email trigger that has several attachments.

[Read Binary Files (loop)] → [easybits Extractor]

All binary attachments across all input items are collected and sent in a single API call.

Extract from an HTTP-downloaded file

Use HTTP Request with "Response Format" set to File to download a PDF or image, then pass it directly to the extractor.

[HTTP Request (download file)] → [easybits Extractor]

Pass a base64 Data URL from a previous step

If you already have a base64 Data URL (e.g. from another API response), use the Data URLs input type.

[HTTP Request / Set node] → [easybits Extractor]

Extractor settings:

  • Input Type: Data URLs
  • Data URL Field: dataUrl (or whatever field contains the Data URL in your JSON)

The JSON item should look like:

{
  "dataUrl": "data:image/png;base64,iVBORw0KGgo..."
}

The field can also contain an array of Data URLs:

{
  "dataUrl": [
    "data:image/jpeg;base64,/9j/4AAQ...",
    "data:application/pdf;base64,JVBERi0..."
  ]
}

Read a Data URL from a nested JSON field

If the Data URL is nested inside the JSON structure, use dot notation in the Data URL Field parameter.

For this JSON:

{
  "response": {
    "attachments": [
      { "url": "data:image/png;base64,iVBORw0KGgo..." }
    ]
  }
}

Set Data URL Field to response.attachments.0.url.

Mix binary files and Data URLs

Use Auto (Both) to collect from both sources at once.

[Read Binary File] ──┐
                      ├──→ [Merge] → [easybits Extractor]
[HTTP Request (JSON)] ┘

Extractor settings:

  • Input Type: Auto (Both)
  • Data URL Field: the field name for items that carry Data URLs

Binary attachments are converted to Data URLs automatically; JSON Data URLs are passed through as-is. Everything is sent in one API call.

Compatibility

Requires n8n v0.187 or later (community node support).

Resources

License

MIT

Discussion