> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ZenRows

> ZenRows is a web scraping API allowing developers to bypass CAPTCHAs and blocks, gather structured data from dynamic websites, and quickly integrate results into applications

![ZenRows logo](https://mintcdn.com/composio-preview/11RkPhDhzt1wdr6a/images/toolkits/zenrows.svg?fit=max\&auto=format\&n=11RkPhDhzt1wdr6a\&q=85\&s=07e7dbb25aac41342b2fffdbe2cf059b)

* **Category:** ai web scraping
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 14
* **Triggers:** 0
* **Slug:** `ZENROWS`
* **Version:** 20261101\_00

## Tools

> [accordion] Get ZenRows API Usage Statistics
>
> **Slug:** `ZENROWS_GET_API_USAGE`
>
> This tool retrieves the current API usage statistics and limits for your ZenRows account. It is an independent action that requires no additional parameters besides authentication. It is useful for monitoring API usage and ensuring that the account has sufficient remaining credits.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Detailed Concurrency Status
>
> **Slug:** `ZENROWS_GET_CONCURRENCY_STATUS_DETAILED`
>
> Requests a test URL through ZenRows and reports concurrency limit and remaining values from response headers when available. A zero limit or remaining value is returned as null.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Original Status Code
>
> **Slug:** `ZENROWS_GET_ORIGINAL_STATUS`
>
> This tool retrieves the original HTTP status code returned by the target website, which is useful for debugging purposes. It returns the original status code in the response headers under 'x-zenrows-original-status'. It can also provide the full response body and error messages, helping with debugging scraping issues, verifying website responses, monitoring availability, and understanding website behavior.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> The URL of the website to check the original status code
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get PDF from URL
>
> **Slug:** `ZENROWS_GET_PDF_FROM_URL`
>
> This tool generates a PDF version of the scraped content from a given URL. It requires JavaScript rendering to be enabled and sets the response type to PDF, making it ideal for archiving web pages, creating documentation, generating reports, or saving articles for offline reading.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> The URL of the webpage to convert to PDF
>
> **wait** `integer`
>
> Time to wait before generating PDF in milliseconds
>
> **premium\_proxy** `boolean`
>
> Whether to use premium proxies
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Plaintext Response
>
> **Slug:** `ZENROWS_GET_PLAINTEXT`
>
> This tool extracts plain text content from a webpage using the ZenRows API. By using the response\_type=plaintext parameter, it strips HTML tags and formats the content into clean, plain text. It's useful for extracting readable content for NLP, summarization, or archiving purposes.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> The URL of the webpage to extract text from
>
> **wait** `integer`
>
> Time to wait for JavaScript execution in milliseconds
>
> **js\_render** `boolean`
>
> Enable JavaScript rendering
>
> **premium\_proxy** `boolean`
>
> Use premium proxy
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Real Estate Property Data
>
> **Slug:** `ZENROWS_GET_REAL_ESTATE_DATA`
>
> Request structured property data for a Zillow or Idealista property by its platform ID. The result standardizes available property, location, feature and seller information; country can be specified, with language and domain options for Idealista.
>
> #### Input Parameters
>
> **tld** `string`
>
> Optional: Top-level domain for Idealista (com, it, pt). Default is com.
>
> **country** `string`
>
> Optional: Target specific country. For Zillow, use 'us'. For Idealista, it's determined by the TLD.
>
> **language** `string`
>
> Optional: Language code for Idealista results. Supported values: en, es, ca, it, pt, fr, de, da, fi, nb, nl, pl, ro, ru, sv, el, zh, uk.
>
> **platform** `string ("zillow" | "idealista")` *required*
>
> The real estate platform to fetch data from. Currently supports 'zillow' or 'idealista'.
>
> **property\_id** `string` *required*
>
> The property ID from the respective platform. For Zillow, it's the ZPID (7-10 digits). For Idealista, it's the property ID from the URL.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Response with Compression
>
> **Slug:** `ZENROWS_GET_RESPONSE_COMPRESSION`
>
> Requests a URL through ZenRows and reports response headers and compression-related metadata, including the reported encoding and content length.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> The URL to fetch content from with compression enabled
>
> **custom\_headers** `object`
>
> Optional custom headers to include in the request. The Accept-Encoding header will be automatically set.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get response headers
>
> **Slug:** `ZENROWS_GET_RESPONSE_HEADERS`
>
> A tool to retrieve and parse response headers from ZenRows API requests. It provides critical metadata such as concurrency limits, available request slots, request cost, unique request ID, and final URL after redirects, which is essential for monitoring usage, debugging, and optimizing requests.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> The URL to scrape and get response headers from
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Session ID
>
> **Slug:** `ZENROWS_GET_SESSION_ID`
>
> This tool implements ZenRows' session management functionality to maintain the same IP address across multiple requests for up to 10 minutes. It supports parameters like url, session\_id, and premium\_proxy, and is useful for maintaining consistent scraping sessions, simulating real user behavior, and avoiding detection by anti-bot systems.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> The target URL to scrape
>
> **session\_id** `integer` *required*
>
> A number between 1 and 99999 to maintain the same IP address across requests
>
> **premium\_proxy** `boolean`
>
> Whether to use premium proxies
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Walmart Product Details
>
> **Slug:** `ZENROWS_GET_WALMART_PRODUCT`
>
> Requests structured Walmart product data from a product URL using ZenRows autoparse and a premium proxy. Returned fields include product details, pricing, ratings and images.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> The Walmart product URL to scrape
>
> **js\_render** `boolean`
>
> Enable JavaScript rendering for dynamic content
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Scrape url autoparse
>
> **Slug:** `ZENROWS_SCRAPE_URL_AUTOPARSE`
>
> The ZENROWS\_SCRAPE\_URL\_AUTOPARSE tool automatically parses and extracts structured data from any given URL using intelligent parsing capabilities. It eliminates the need for manual CSS selectors by auto-identifying relevant content on web pages, returning data such as titles, main content, meta descriptions, images, links, prices, and contact information in a structured JSON format.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> The URL to be scraped and automatically parsed.
>
> **wait** `integer`
>
> Time to wait for JavaScript execution in milliseconds.
>
> **js\_render** `boolean`
>
> Enable JavaScript rendering for dynamic content.
>
> **premium\_proxy** `boolean`
>
> Use premium proxy for better success rate.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Scrape URL HTML
>
> **Slug:** `ZENROWS_SCRAPE_URL_HTML`
>
> This tool extracts raw HTML data from a given URL using ZenRows' Universal Scraper API. It focuses on retrieving the pure HTML content of the webpage without automatic parsing or data extraction. It supports parameters such as js\_render for enabling JavaScript rendering, custom\_headers for custom HTTP headers, premium\_proxy for using premium proxies, and session\_id for maintaining the same IP across multiple requests.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> The URL to scrape content from
>
> **wait** `integer`
>
> Time to wait in milliseconds after page load
>
> **wait\_for** `string`
>
> CSS selector to wait for before returning content
>
> **js\_render** `boolean`
>
> Enable JavaScript rendering for dynamic content
>
> **session\_id** `string`
>
> Session ID to maintain the same IP across requests
>
> **premium\_proxy** `boolean`
>
> Use premium proxies for the request
>
> **proxy\_country** `string`
>
> Country code for proxy location (requires premium\_proxy)
>
> **custom\_headers** `object`
>
> Custom HTTP headers to include in the request
>
> **original\_status** `boolean`
>
> Return original HTTP status code
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Scrape URL with CSS Selectors
>
> **Slug:** `ZENROWS_SCRAPE_WITH_CSS_SELECTORS`
>
> Scrapes specific webpage elements using a URL and a map of CSS selectors. Supports JavaScript rendering, premium proxies and wait options for targeted data extraction.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> The URL of the webpage to scrape
>
> **wait** `integer`
>
> Time to wait in milliseconds before scraping
>
> **wait\_for** `string`
>
> CSS selector to wait for before scraping
>
> **js\_render** `boolean`
>
> Enable JavaScript rendering for dynamic content
>
> **css\_selectors** `object` *required*
>
> A dictionary of CSS selectors where keys are labels and values are the selectors
>
> **premium\_proxy** `boolean`
>
> Use premium proxies for the request
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Screenshot URL
>
> **Slug:** `ZENROWS_SCREENSHOT_URL`
>
> A tool to capture screenshots of web pages using ZenRows API. This tool allows you to take screenshots of entire web pages or specific elements, with customizable options for format and quality.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> The URL of the webpage to capture screenshot.
>
> **wait** `integer`
>
> Time to wait before taking screenshot (in milliseconds).
>
> **screenshot\_format** `string`
>
> Image format for the screenshot. Either 'png' or 'jpeg'.
>
> **screenshot\_quality** `integer`
>
> Image quality (1-100). Only applicable when format is 'jpeg'.
>
> **screenshot\_fullpage** `boolean`
>
> Set to true to capture the entire page instead of just the visible viewport.
>
> **screenshot\_selector** `string`
>
> CSS selector to capture a specific element. Cannot be used with screenshot\_fullpage.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
