Context
Part of #121 — improving the integration for Zapier Agents compatibility.
Problem
A very common agent pattern is: run a scraper → immediately use the results. Currently this requires 2–3 steps in Zapier: Run Actor (sync) + Fetch Dataset Items. The 30-second sync timeout is also severely limiting for agents that need actual results.
Agents work best with focused, single-step actions that return everything they need in one call.
Proposed Solution
Add a new create action that runs an actor synchronously (with a longer wait) and automatically returns dataset items in the same response:
- Key:
runActorAndFetchResults
- Noun:
Actor Results
- Label:
Run Actor and Fetch Results
- Description:
Runs an Actor and waits for it to finish, then returns the dataset items produced by the run — all in a single step. Best suited for short-running Actors (under 5 minutes) where you need the scraped data immediately. For long-running Actors, use Run Actor (async) + Fetch Dataset Items separately.
- Inputs:
- Same actor selection fields as Run Actor
limit (optional, integer, default 10) — number of dataset items to return
fields (optional, string) — comma-separated fields to include
- Output: run metadata +
items[] array inline
Notes
- The existing
waitForRunToFinish in request_helpers.js already supports a configurable timeout — this action could use a longer default (e.g. 5 minutes).
- Consider whether this should be a separate action or an enhancement to the existing Run Actor action with an "also fetch results" checkbox.
Context
Part of #121 — improving the integration for Zapier Agents compatibility.
Problem
A very common agent pattern is: run a scraper → immediately use the results. Currently this requires 2–3 steps in Zapier: Run Actor (sync) + Fetch Dataset Items. The 30-second sync timeout is also severely limiting for agents that need actual results.
Agents work best with focused, single-step actions that return everything they need in one call.
Proposed Solution
Add a new create action that runs an actor synchronously (with a longer wait) and automatically returns dataset items in the same response:
runActorAndFetchResultsActor ResultsRun Actor and Fetch ResultsRuns an Actor and waits for it to finish, then returns the dataset items produced by the run — all in a single step. Best suited for short-running Actors (under 5 minutes) where you need the scraped data immediately. For long-running Actors, use Run Actor (async) + Fetch Dataset Items separately.limit(optional, integer, default 10) — number of dataset items to returnfields(optional, string) — comma-separated fields to includeitems[]array inlineNotes
waitForRunToFinishinrequest_helpers.jsalready supports a configurable timeout — this action could use a longer default (e.g. 5 minutes).