Package Information
Documentation
n8n-nodes-easybits-extractor
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:
- Create a pipeline at extractor.easybits.tech
- Use this node in n8n to send PDF, JPG, or PNG files to your pipeline
- 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
- Collects files from all input items (as binary attachments, Data URLs, or both — depending on Input Type)
- Converts binary files to base64 Data URLs; passes Data URLs through as-is
- POSTs them all to
https://extractor.easybits.tech/api/pipelines/{pipelineId}with Bearer auth - 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).