n8n-nodes-wellmarked

Official n8n community node for the WellMarked API — extract clean Markdown from any URL, crawl whole sites, and run bulk jobs from inside an n8n workflow.

Install

In your n8n instance:

1. Settings → Community Nodes → Install
2. Enter n8n-nodes-wellmarked and click Install.
3. Restart n8n if your install requires it.

Or for self-hosted n8n via the CLI:

npm install n8n-nodes-wellmarked

Requires n8n 1.0+ and Node.js 20.15+.

Credentials

Create a WellMarked API credential with your wm_... key. Get one at wellmarked.io. The credential test calls GET /usage, which validates the key without consuming any quota.

Operations

The node uses the standard n8n Resource + Operation model.

Extract

• Extract URL — POST /extract. One URL in, one Markdown result out per input item.
  • Fields: URL, Render JavaScript (Pro+).

Bulk Job

For batches of URLs (Pro and Growth: up to 50 per job; Enterprise: unlimited).

• Submit — POST /bulk. Returns the job envelope (job_id, status: "queued", etc.) and continues immediately. Use this when you want to poll later or run other steps in parallel.
• Get Status — GET /bulk/{job_id} (polymorphic — also works on crawl job IDs).
• Submit and Wait — submits, then polls every N seconds until done, then fans the results out as one n8n item per URL so downstream nodes process each extraction individually.

Crawl Job

Same three operations against POST /crawl / GET /crawl/{job_id}. Plan caps: Pro is depth ≤ 5 and ≤ 2,000 pages; Growth is depth ≤ 10 and ≤ 10,000 pages; Enterprise is unlimited. Each crawl job fetches up to 8 pages concurrently.

• Submit and Wait fans results out as one item per page.
• The output items include depth (BFS distance from the root) and the truncated / truncated_reason fields when the crawl stopped early.

Account

• Get Usage — GET /usage. Returns plan, period, used / limit / remaining. Free; does not count against quota.

Long-running jobs

Submit and Wait blocks the n8n execution while polling. n8n workflows typically have a workflow timeout (default 30 min self-hosted, less on n8n Cloud); if your bulk batch or crawl might run longer than that, use Submit + a separate Get Status call in a follow-up step or scheduled workflow.

The default poll interval is 2 s and the default wait timeout is 300 s — both configurable on the node.

Webhooks (alternative to polling)

The WellMarked API supports outbound webhooks: pass a webhook_url on POST /bulk or POST /crawl and we POST a signed job.completed notification to your URL when the job finishes — no polling needed.

This node does not yet expose a Webhook URL field on the Submit operations — open an issue if you want it. In the meantime, a workflow that combines an n8n Webhook trigger with an HTTP Request node to POST /bulk (or /crawl) achieves the same:

1. Add an n8n Webhook trigger node — n8n gives you a public URL.
2. HTTP Request node → POST https://api.wellmarked.io/bulk with body { "urls": [...], "webhook_url": "<the n8n webhook URL>" } and your Authorization: Bearer wm_... header.
3. The first response carries webhook_signing_secret (shown once — store it as an n8n credential or env var).
4. In the webhook trigger's downstream flow, verify X-WellMarked-Signature against your stored secret before acting on the payload.

See the WellMarked Webhooks docs for the signature scheme, retry policy, and payload shape.

Errors

The node surfaces every WellMarked error code (rate_limit_too_fast, rate_limit_exceeded, target_timeout, plan_not_supported, etc.) as an n8n NodeApiError with the original message and HTTP status. Toggle Continue On Fail on the node if you want per-URL failures to emit { error: "..." } items instead of stopping the workflow.

The per-second rate limit (Free 5/s · Pro 20/s · Growth 100/s · Enterprise unlimited) surfaces as rate_limit_too_fast 429s. If you're polling status with tight intervals, set the Poll Interval above your tier's spacing (200 ms for Free, 50 ms for Pro, 10 ms for Growth) to avoid spurious rejections.

Development

git clone https://github.com/WellMarkedAPI/n8n.git
cd n8n
npm install
npm run build         # compiles to dist/ and copies icons
npm link              # makes the package globally linkable

# In your n8n install dir:
cd ~/.n8n/custom
npm link n8n-nodes-wellmarked
# Restart n8n; the WellMarked node appears in the palette.

License

Copyright © 2026 WellMarked. Released under the MIT License.

Source: https://github.com/WellMarkedAPI/n8n

Use of the hosted API at api.wellmarked.io remains subject to the
Terms of Service.