Skip to docs navigation

Zenrows integration guide

Verified

How to connect Zenrows to WEXTL and use its 1 trigger and 51 actions in your workflows. About Zenrows: Web scraping API with anti-bot bypass, crawling and batch jobs.

  • 1 trigger
  • 27 searches
  • 24 actions
  • Instant (webhooks)
  • Auth: API key

AI-assisted documentation18 min read

This documentation is compiled from our integration source code, internal specs for Zenrows, its official API documentation and anonymized requests logs we collect from our support team[2].

Open Zenrows on WEXTL →
  • Zenrows
  • WEXTL
  • Bright Data
  • Browse AI
  • Agenty
  • BugBug
  • CloudConvert
  • Currents
  • AWS S3
  • CircleCI
  • Apify
  • Alchemy
  • Better Stack
  • Buildkite
  • Contentful
  • Crowdin
  • Cortex
  • Clerk
  • Browserless
  • AWS Lambda
  • Azure Storage
  • AssemblyAI
  • Cockpit
  • Adafruit
  • Bunny.net
  • Cloudflare
  • AWS Cognito
  • 0CodeKit
  • API Verve
  • Bitbucket
  • Box
  • Bitwarden
  • API KeypasswordRequired

    In the dashboard open Settings, then API keys, and copy a key. An account can hold up to 10 keys, each with its own credit cap.[1]

  1. Log in to your WEXTL account, add the Zenrows node module to your workflow, and click Create new credential.Instant triggers use webhooks. Click Create a webhook first when adding one, then create the credential.
  2. Optional: In the Credential name field, enter a name for the credential.
  3. Enter the authentication credentials you copied from your Zenrows account, or follow the on-screen instructions to create the credential.
  4. If prompted, authenticate your account and confirm access.
  5. If you want to make changes to your credential in the future, follow the steps in Manage credentials →

Watch Job Events

TriggerInstant trigger on batch job events.
Output fields[3]
FieldType
Schematext
Event idtext
Event typetext
Occurred atdate
Job idtext
External idtext
Metadataobject
Teamtext
Run idtext
Run sequencenumber
Statsobject
Totalnumber
Completednumber
Successfulnumber
Failednumber
Spendobject

Capture a Screenshot

SearchImage file of a page or one element on it.
Input fields[3]
FieldType
URLRequired
text
Full Pageboolean
Formatchoice
JPEG Qualitynumber
Element Selectortext
Premium Proxyboolean
Proxy Countrytext
Wait Fortext
Waitnumber
Output fields[3]
FieldType
Filefile
FileNametext
ContentTypetext

Convert a Page to PDF

SearchPage rendered into a PDF file.
Input fields[3]
FieldType
URLRequired
text
JavaScript Renderingboolean
Premium Proxyboolean
Proxy Countrytext
Wait Fortext
Waitnumber
Output fields[3]
FieldType
Filefile
FileNametext
ContentTypetext

Download Crawl Results

SearchCrawl output saved to a file.
Input fields[3]
FieldType
CrawlRequired
choice
Output fields[3]
FieldType
Filefile
FileNametext
ContentTypetext

Extract Page Data

SearchStructured product data read from a site.
Input fields[3]
FieldType
URLRequired
text
Extract ModeRequired
choice
Fieldstext
JavaScript Renderingboolean
Premium Proxyboolean
Proxy Countrytext
Modechoice
Output fields[3]
FieldType
Productsarray
Productobject

Fetch a Page

SearchScraped content of a URL.
Input fields[3]
FieldType
URLRequired
text
Modechoice
JavaScript Renderingboolean
Premium Proxyboolean
Proxy Countrytext
Response Typechoice
CSS Extractortext
JavaScript Instructionstext
Wait Fortext
Waitnumber
Custom Headersboolean
Headersarray
Headerobject
Session IDnumber
Original Statusboolean
Allowed Status Codestext
Block Resourcestext
JSON Responseboolean
Outputstext
Output fields[3]
FieldType
Bodytext
Content Typetext

Fetch a Page With POST

ActionPage body fetched by sending data to it.
Input fields[3]
FieldType
URLRequired
text
Modechoice
JavaScript Renderingboolean
Premium Proxyboolean
Proxy Countrytext
Response Typechoice
CSS Extractortext
JavaScript Instructionstext
Wait Fortext
Waitnumber
Custom Headersboolean
Headersarray
Headerobject
Session IDnumber
Original Statusboolean
Allowed Status Codestext
Block Resourcestext
JSON Responseboolean
Outputstext
Bodytext
Body Typechoice
Output fields[3]
FieldType
Bodytext
Content Typetext

Get a Batch Job

SearchSetup and state of one batch job.
Input fields[3]
FieldType
Batch JobRequired
choice
Output fields[3]
FieldType
Job idtext
Typetext
Statustext
Formattext
Template tasksarray
Template taskobject
Zenrows paramsobject
Js rendertext
External idtext
Nametext
Metadataobject
Teamtext
Scheduleobject
Rateobject
Timezonetext
Next scheduled runtext
Schedule statetext
Webhookobject
URLtext
Signatureboolean
Latest runobject
Run idtext
Job idtext
Run sequencenumber
Statustext
Triggertext
Statsobject
Last batch receivedboolean
Pause statetext
Ingest statustext
Created atdate
Created atdate
Updated atdate

Get a Batch Run

SearchProgress report for a job run.
Input fields[3]
FieldType
Batch JobRequired
choice
RunRequired
choice
Output fields[3]
FieldType
Run idtext
Job idtext
Run sequencenumber
Statustext
Triggertext
Statsobject
Totalnumber
Completednumber
Successfulnumber
Failednumber
Failure reasonsobject
Spendobject
Last batch receivedboolean
Pause statetext
Ingest statustext
Created atdate
Updated atdate

Get a Crawl

SearchSettings and state of one crawl.
Input fields[3]
FieldType
CrawlRequired
choice
Cursortext
Output fields[3]
FieldType
Crawl idtext
Statustext
URLtext
Depthnumber
Max itemsnumber
Max pagesnumber
Include patternsarray
Exclude patternsarray
Output formattext
Discoveryarray
Coverageobject
Pages fetchednumber
Pages failednumber
Items foundnumber
Duplicates removednumber
Created atdate
Resultsarray
Resultobject
Next cursortext

Get a Crawl Page

SearchA single page collected during a crawl.
Input fields[3]
FieldType
CrawlRequired
choice
Content IDRequired
text
Download as Fileboolean
Output fields[3]
FieldType
Filefile
Htmltext
ContentTypetext

Get a Domain Preparation Status

SearchProgress of a site being prepared for extraction.
Input fields[3]
FieldType
DomainRequired
text
Output fields[3]
FieldType
Domaintext
Statustext
Statetext
Rolesarray
Roleobject
Failureobject
Codetext
Detailtext
Slot consumedboolean
Submitted atdate
Updated atdate

Get a Job Webhook

SearchWebhook settings of a batch job.
Input fields[3]
FieldType
Batch JobRequired
choice
Output fields[3]
FieldType
URLtext
Signatureboolean

Get a Preparation Allowance

SearchMonthly domain preparation quota.
Output fields[3]
FieldType
Usednumber
Limitnumber
Remainingnumber
Monthtext

Get a Results Export

SearchState and link of a results export.
Input fields[3]
FieldType
Batch JobRequired
choice
RunRequired
choice
Export IDRequired
text
Output fields[3]
FieldType
Export idtext
Statustext
Download urltext
Created atdate
Expires atdate

Get Latest Run Results

SearchTask outcomes from the latest execution.
Input fields[3]
FieldType
Batch JobRequired
choice
LimitRequired
number
Statuschoice
Output fields[3]
FieldType
Task idtext
External idtext
Run idtext
URLtext
Metadataobject
Teamtext
Methodtext
Statustext
Typetext
Result urltext
Spendobject
Creditsnumber
Costnumber
Created atdate
Updated atdate

Get Latest Task Content

SearchScraped body of a task from the latest execution.
Input fields[3]
FieldType
Batch JobRequired
choice
Task IDRequired
text
Download as Fileboolean
Output fields[3]
FieldType
Filefile
Bodytext
ContentTypetext

Get Latest Task History

SearchEvent log from the latest execution of a task.
Input fields[3]
FieldType
Batch JobRequired
choice
Task IDRequired
text
Output fields[3]
FieldType
Eventsarray
Eventobject

Get Plan Usage

SearchCredit consumption on your subscription.
Output fields[3]
FieldType
Statustext
Period starts atdate
Period ends atdate
Usagenumber
Usage creditsnumber
Credit limitnumber
Usage percentnumber
Planobject
Nametext
Pricenumber
Unit costnumber
Recurrencetext
Productsobject
Top upsarray
Api keyobject
Capsarray

Get Run Results

SearchTask outcomes for a specific run.
Input fields[3]
FieldType
Batch JobRequired
choice
RunRequired
choice
LimitRequired
number
Statuschoice
Output fields[3]
FieldType
Task idtext
External idtext
Run idtext
URLtext
Metadataobject
Teamtext
Methodtext
Statustext
Typetext
Result urltext
Spendobject
Creditsnumber
Costnumber
Created atdate
Updated atdate

Get Run Task Content

SearchPage body saved by one task of a run.
Input fields[3]
FieldType
Batch JobRequired
choice
RunRequired
choice
Task IDRequired
text
Download as Fileboolean
Output fields[3]
FieldType
Filefile
Bodytext
ContentTypetext

Get Run Task History

SearchEvent log of a task in a selected run.
Input fields[3]
FieldType
Batch JobRequired
choice
RunRequired
choice
Task IDRequired
text
Output fields[3]
FieldType
Eventsarray
Eventobject

List Batch Jobs

SearchYour batch jobs filtered by state or kind.
Input fields[3]
FieldType
LimitRequired
number
Statuschoice
Typechoice
Output fields[3]
FieldType
Job idtext
Typetext
Statustext
Formattext
Template tasksarray
Template taskobject
Zenrows paramsobject
Js rendertext
External idtext
Nametext
Metadataobject
Teamtext
Scheduleobject
Rateobject
Timezonetext
Next scheduled runtext
Schedule statetext
Webhookobject
URLtext
Signatureboolean
Latest runobject
Run idtext
Job idtext
Run sequencenumber
Statustext
Triggertext
Statsobject
Last batch receivedboolean
Pause statetext
Ingest statustext
Created atdate
Created atdate
Updated atdate

List Batch Runs

SearchExecutions of one batch job.
Input fields[3]
FieldType
Batch JobRequired
choice
LimitRequired
number
Output fields[3]
FieldType
Run idtext
Job idtext
Run sequencenumber
Statustext
Triggertext
Statsobject
Totalnumber
Completednumber
Successfulnumber
Failednumber
Failure reasonsobject
Spendobject
Last batch receivedboolean
Pause statetext
Ingest statustext
Created atdate
Updated atdate

List Crawls

SearchCrawls started on this account.
Input fields[3]
FieldType
LimitRequired
number
Output fields[3]
FieldType
Crawl idtext
Statustext
URLtext
Depthnumber
Max itemsnumber
Max pagesnumber
Include patternsarray
Exclude patternsarray
Output formattext
Discoveryarray
Coverageobject
Pages fetchednumber
Pages failednumber
Items foundnumber
Duplicates removednumber
Created atdate

List Extract Domains

SearchSites the extractor knows.
Input fields[3]
FieldType
LimitRequired
number
Output fields[3]
FieldType
Domaintext
Verticalsarray
Warmboolean

List HMAC Keys

SearchKeys that sign your webhooks.
Output fields[3]
FieldType
Activeobject
Kidtext
Created atdate
Candidateobject
Kidtext
Created atdate

List Prepared Domains

SearchSites submitted for preparation so far.
Input fields[3]
FieldType
LimitRequired
number
Output fields[3]
FieldType
Domaintext
Statustext
Statetext
Rolesarray
Roleobject
Failureobject
Codetext
Detailtext
Slot consumedboolean
Submitted atdate
Updated atdate

Add Tasks to a Batch Job

ActionQueues more URLs on an existing batch job.
Input fields[3]
FieldType
Batch JobRequired
choice
TasksRequired
array
Taskobject
Last Batchboolean
Output fields[3]
FieldType
Accepted tasksnumber
Job statustext
Latest runobject
Run idtext
Job idtext
Run sequencenumber
Statustext
Triggertext
Statsobject
Last batch receivedboolean
Pause statetext
Ingest statustext
Created atdate

Cancel an HMAC Key Rotation

ActionAborts a webhook key swap in progress.
Output fields[3]
FieldType
Cancelledboolean

Close a Batch Job

ActionMarks a batch job as complete for new tasks.
Input fields[3]
FieldType
Batch JobRequired
choice
Output fields[3]
FieldType
Job idtext
Typetext
Statustext
Formattext
Template tasksarray
Template taskobject
Zenrows paramsobject
Js rendertext
External idtext
Nametext
Metadataobject
Teamtext
Scheduleobject
Rateobject
Timezonetext
Next scheduled runtext
Schedule statetext
Webhookobject
URLtext
Signatureboolean
Latest runobject
Run idtext
Job idtext
Run sequencenumber
Statustext
Triggertext
Statsobject
Last batch receivedboolean
Pause statetext
Ingest statustext
Created atdate
Created atdate
Updated atdate

Create a Batch Job

ActionNew asynchronous scraping job.
Input fields[3]
FieldType
Typechoice
Statuschoice
Nametext
Tasksarray
Taskobject
CSV Upload IDtext
Zenrows Paramstext
External IDtext
Metadataarray
Entryobject
Schedulechoice
Timezonetext
Webhook URLtext
Sign Webhookboolean
Output fields[3]
FieldType
Job idtext
Statustext
Latest runobject
Run idtext
Job idtext
Run sequencenumber
Statustext
Triggertext
Statsobject
Last batch receivedboolean
Pause statetext
Ingest statustext
Created atdate
Accepted tasksnumber
Webhookobject
URLtext
Signatureboolean

Create an Input Upload Slot

ActionUpload target for a spreadsheet of pages.
Input fields[3]
FieldType
URL ColumnRequired
text
External ID Columntext
Has Header Rowboolean
Delimitertext
Quote Charactertext
Output fields[3]
FieldType
File input idtext
Uploadobject
Methodtext
URLtext
Headersobject
Expires atdate
Expires atdate

Delete a Batch Job

ActionBatch job removed from the account.
Input fields[3]
FieldType
Batch JobRequired
choice
Output fields[3]
FieldType
Job idtext
Acceptedboolean

Delete a Batch Run

ActionClears one execution of a job.
Input fields[3]
FieldType
Batch JobRequired
choice
RunRequired
choice
Output fields[3]
FieldType
Job idtext
Run idtext
Acceptedboolean

Fetch a Page With PUT

ActionPage content loaded with a request body.
Input fields[3]
FieldType
URLRequired
text
Modechoice
JavaScript Renderingboolean
Premium Proxyboolean
Proxy Countrytext
Response Typechoice
CSS Extractortext
JavaScript Instructionstext
Wait Fortext
Waitnumber
Custom Headersboolean
Headersarray
Headerobject
Session IDnumber
Original Statusboolean
Allowed Status Codestext
Block Resourcestext
JSON Responseboolean
Outputstext
Bodytext
Body Typechoice
Output fields[3]
FieldType
Bodytext
Content Typetext

Finalize an HMAC Key Rotation

ActionCompletes a signing key swap.
Output fields[3]
FieldType
Active kidtext
Created atdate

Make an API Call

universalCustom Zenrows REST API request.
Input fields[3]
FieldType
HostRequired
choice
URLRequired
text
MethodRequired
choice
Headersarray
Headerobject
Query Stringarray
Parameterobject
Bodytext
Output fields[3]
FieldType
Bodytext
Headersobject
Status codenumber

Pause a Batch Run

ActionHalts a job run for later resuming.
Input fields[3]
FieldType
Batch JobRequired
choice
Output fields[3]
FieldType
Run idtext
Job idtext
Run sequencenumber
Statustext
Triggertext
Statsobject
Totalnumber
Completednumber
Successfulnumber
Failednumber
Failure reasonsobject
Spendobject
Last batch receivedboolean
Pause statetext
Ingest statustext
Created atdate
Updated atdate

Remove a Job Webhook

ActionWebhook detached from a batch job.
Input fields[3]
FieldType
Batch JobRequired
choice
Output fields[3]
FieldType
Job idtext
Removedboolean

Request a Domain Preparation

ActionStarts preparing a site for extraction.
Input fields[3]
FieldType
DomainRequired
text
Example URLsarray
Output fields[3]
FieldType
Domaintext
Statustext
Statetext
Rolesarray
Roleobject
Failureobject
Codetext
Detailtext
Slot consumedboolean
Submitted atdate
Updated atdate

Rerun a Batch Job

ActionStarts a fresh run, retrying chosen tasks.
Input fields[3]
FieldType
Batch JobRequired
choice
Statuses to Retrytext
Output fields[3]
FieldType
Job idtext
Statustext
Latest runobject
Run idtext
Job idtext
Run sequencenumber
Statustext
Triggertext
Statsobject
Last batch receivedboolean
Pause statetext
Ingest statustext
Created atdate
Rerun oftext
Retried tasksnumber
Inherited tasksnumber

Resume a Batch Run

ActionRestarts a paused job run.
Input fields[3]
FieldType
Batch JobRequired
choice
Output fields[3]
FieldType
Run idtext
Job idtext
Run sequencenumber
Statustext
Triggertext
Statsobject
Totalnumber
Completednumber
Successfulnumber
Failednumber
Failure reasonsobject
Spendobject
Last batch receivedboolean
Pause statetext
Ingest statustext
Created atdate
Updated atdate

Send a Test Webhook

ActionSample delivery to your endpoint.
Input fields[3]
FieldType
URLRequired
text
Sign Webhookboolean
Output fields[3]
FieldType
Deliveredboolean
Event idtext
Status codenumber
Errortext
Elapsed msnumber

Set a Batch Schedule

ActionDefines when a job runs.
Input fields[3]
FieldType
Batch JobRequired
choice
ScheduleRequired
choice
Timezonetext
Output fields[3]
FieldType
Job idtext
Typetext
Statustext
Formattext
Template tasksarray
Template taskobject
Zenrows paramsobject
Js rendertext
External idtext
Nametext
Metadataobject
Teamtext
Scheduleobject
Rateobject
Timezonetext
Next scheduled runtext
Schedule statetext
Webhookobject
URLtext
Signatureboolean
Latest runobject
Run idtext
Job idtext
Run sequencenumber
Statustext
Triggertext
Statsobject
Last batch receivedboolean
Pause statetext
Ingest statustext
Created atdate
Created atdate
Updated atdate

Set a Batch Schedule State

ActionActivates or pauses a job timetable.
Input fields[3]
FieldType
Batch JobRequired
choice
StateRequired
choice
Output fields[3]
FieldType
Job idtext
Typetext
Statustext
Formattext
Template tasksarray
Template taskobject
Zenrows paramsobject
Js rendertext
External idtext
Nametext
Metadataobject
Teamtext
Scheduleobject
Rateobject
Timezonetext
Next scheduled runtext
Schedule statetext
Webhookobject
URLtext
Signatureboolean
Latest runobject
Run idtext
Job idtext
Run sequencenumber
Statustext
Triggertext
Statsobject
Last batch receivedboolean
Pause statetext
Ingest statustext
Created atdate
Created atdate
Updated atdate

Set a Job Webhook

ActionPoints job events at your endpoint.
Input fields[3]
FieldType
Batch JobRequired
choice
URLRequired
text
Sign Webhookboolean
Output fields[3]
FieldType
URLtext
Signatureboolean

Start a Crawl

ActionBegins a bounded site crawl.
Input fields[3]
FieldType
URLRequired
text
Depthnumber
Max Itemsnumber
Max Pagesnumber
Include Patternsarray
Exclude Patternsarray
Output Formatchoice
Output fields[3]
FieldType
Crawl idtext
Statustext
URLtext
Depthnumber
Max itemsnumber
Max pagesnumber
Include patternsarray
Exclude patternsarray
Output formattext
Discoveryarray
Coverageobject
Pages fetchednumber
Pages failednumber
Items foundnumber
Duplicates removednumber
Created atdate
Resultsarray
Next cursortext

Start a Results Export

ActionPacks run results into a download.
Input fields[3]
FieldType
Batch JobRequired
choice
RunRequired
choice
Output fields[3]
FieldType
Export idtext
Statustext
Created atdate
Expires atdate

Start an HMAC Key Rotation

ActionIssues a new webhook signing key.
Output fields[3]
FieldType
Kidtext
Secrettext
Created atdate

Stop a Batch Run

ActionEnds a job run before it completes.
Input fields[3]
FieldType
Batch JobRequired
choice
Output fields[3]
FieldType
Run idtext
Job idtext
Run sequencenumber
Statustext
Triggertext
Statsobject
Totalnumber
Completednumber
Successfulnumber
Failednumber
Failure reasonsobject
Spendobject
Last batch receivedboolean
Pause statetext
Ingest statustext
Created atdate
Updated atdate

Stop a Crawl

ActionEnds a crawl before it finishes.
Input fields[3]
FieldType
CrawlRequired
choice
Output fields[3]
FieldType
Crawl idtext
Statustext
Stop reasontext
Finished atdate

Look for Zenrows templates in the WEXTL template library.

Browse templates →
  1. WEXTL® Zenrows Source Code connector implementation.
  2. Our users use cases and automations.
  3. Official API Documentation for Zenrows.
  4. WEXTL® visual workflow builder data.

Last updated: Nov 14, 2026 16:51

How we write our apps documentation

How we compile these docs: sources, the role of AI, and how we verify.