Scrapeer
Extraction

Enrich Items Block

Enrich Items reads a list variable, visits each item URL, extracts configured fields, and writes an enriched list.

At a glance

Best for
Detail-page enrichment
Input
List variable with URLs
Runtime
Cloud-only behavior
Error handle
Yes

What it does

Enrich Items is for workflows where a list page provides URLs and each detail page has more data.

It reads items from an input list, opens detail pages with controlled concurrency, extracts configured fields, and writes the enriched list.

Use it when

  • Add detail-page fields to rows extracted from a listing page.
  • Visit product, job, or profile links from a previous Extract Data result.
  • Merge detail-page data back into the original item objects.

Do not use it when

  • You only need fields already visible on the list page.
  • The input list does not include usable URLs.
  • You need local runtime support for this step.

Settings

Enrich Items needs an input list, URL field, output variable, and field extraction rules for each detail page.

Input variable

Required: Yes
Variables
Variable name
Description
List variable containing item objects.

URL field

Required: Yes
Variables
No
Description
Field on each item that contains the detail-page URL.

Fields

Required: Yes
Variables
Selectors can use variables
Description
Detail-page field extraction definitions.

Maximum items

Required: No
Variables
Yes
Description
Limits how many unique detail pages the Block attempts. Empty processes every usable URL in the input list.

Concurrency

Required: No
Variables
No
Description
Automatic (recommended) uses the Cloud Run worker’s conservative safe setting. Manual options request 1, 2, or 3 pages at a time; the runtime can reduce the effective value.

Output variable

Required: Yes
Variables
Variable name
Description
Stores the enriched item list.

Outputs

Enrich Items writes a new enriched list and run statistics.

{{outputVariableName}}array<object>

Input item objects merged with extracted detail-page fields.

statsobject

Runtime counts plus the configured mode, requested concurrency, effective concurrency, and runtime maximum.

Example Flow

Enrich Items follows a list extraction step and opens each detail URL before final export.

  1. Extract rows that include a detail URL field.
  2. Use Enrich Items to visit each detail page.
  3. Export the enriched list to a spreadsheet or file.

Errors and fixes

Start with symptoms visible in the editor or Inspector, then check the earliest Block that produced the wrong page state, variable, or output.

No items are enriched.

Check
Check that the input variable is a list and that each item has the configured URL field.
Fix
Fix the upstream Extract Data field or URL field setting.

The Block fails locally.

Check
Check the runtime.
Fix
Run this workflow in Cloud Run because Enrich Items is cloud-only.

The target starts returning errors during enrichment.

Check
Check the failed-item count and effective concurrency in the Block result.
Fix
Change Concurrency from Automatic to 1 page at a time, then run the Flow again.

Local and cloud runs

Enrich Items is implemented for Cloud Runs. Local runs should not be documented as supported for this Block until parity exists.

Automatic concurrency uses the worker’s configured safe default and maximum. It does not currently adjust from live CPU or memory pressure.

Blocks

Understand how Blocks connect and pass state through a Flow.

Runs and outputs

Inspect Block output, errors, and variables after a run.