> ## 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.

# MrScraper

> MrScraper provides web scraping APIs for structured extraction, search results, marketplace data, travel data, and web unblocking.

![MrScraper logo](https://mintcdn.com/composio-preview/9YPuzjEU4UlMnwGq/images/toolkits/mrscraper.svg?fit=max\&auto=format\&n=9YPuzjEU4UlMnwGq\&q=85\&s=2b48b77b7b0c6caeb1d8cae46979c12c)

* **Category:** web scraping & browser
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 11
* **Triggers:** 0
* **Slug:** `MRSCRAPER`
* **Version:** 20261026\_00
* **Instant:** Supported on the latest version. Support varies by tool.

## Tools

> [accordion] Bulk Rerun AI Scraper
>
> **Slug:** `MRSCRAPER_BULK_RERUN_AI_SCRAPER`
>
> Run an existing General AI scraper configuration against multiple URLs in one request. Returns the accepted bulk result ID for Get Scrape Result.
>
> #### Input Parameters
>
> **urls** `array` *required*
>
> One or more HTTP or HTTPS URLs to process with the existing AI scraper.
>
> **scraper\_id** `string` *required*
>
> UUID of an existing General AI scraper configuration to run against every 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] Bulk Rerun Manual Scraper
>
> **Slug:** `MRSCRAPER_BULK_RERUN_MANUAL_SCRAPER`
>
> Run an existing saved manual scraper workflow against multiple URLs in one request. Returns the accepted bulk result ID for Get Scrape Result.
>
> #### Input Parameters
>
> **urls** `array` *required*
>
> Non-empty list of HTTP or HTTPS URLs to process with the saved workflow.
>
> **scraper\_id** `string` *required*
>
> UUID of the existing manual scraper workflow to rerun.
>
> #### 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] Create AI Scraper
>
> **Slug:** `MRSCRAPER_CREATE_AI_SCRAPER`
>
> Create and run a general, listing, or map AI scraper against a website.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.995 per 1,000 tokens used
>
> **Discount:** 5
>
> #### Input Parameters
>
> **url** `string` *required*
>
> HTTP or HTTPS website URL to scrape.
>
> **agent** `string ("general" | "listing" | "map")`
>
> AI scraper mode: general extraction, repeated-item listing extraction, or site mapping.
>
> **limit** `integer`
>
> Map-only maximum extracted entries (1-100000); omit for the provider default of 1000.
>
> **message** `string`
>
> Natural-language extraction instructions. Required for general and listing modes; omit for map mode.
>
> **max\_depth** `integer`
>
> Map-only maximum link depth (0-5); omit to use the provider default of 2.
>
> **max\_pages** `integer`
>
> Map-only maximum pages to crawl (1-1000); omit for the default of 50.
>
> **proxy\_country** `string`
>
> Two-letter country code for geo-localized scraping.
>
> **exclude\_patterns** `array`
>
> Map-only URL regex patterns to exclude.
>
> **include\_patterns** `array`
>
> Map-only URL regex patterns to include.
>
> #### 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 Account Usage
>
> **Slug:** `MRSCRAPER_GET_ACCOUNT_USAGE`
>
> Return the connected MrScraper account's plan, token usage, concurrency allowance, and rate limits without exposing user identity or token details.
>
> #### 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 Scrape Status Analytics
>
> **Slug:** `MRSCRAPER_GET_ANALYTIC_STATUSES`
>
> Return aggregate scrape counts, success rate, request rate, latency, and status totals for a domain and action over a time range.
>
> #### Input Parameters
>
> **action** `string`
>
> Optional custom-scraper action filter, such as create, rerun, bulk, or fetch HTML; omit to aggregate all actions.
>
> **domain** `string` *required*
>
> Domain to aggregate, without a URL path (for example example.com).
>
> **end\_date** `string` *required*
>
> Range end in yyyy-MM-dd HH:mm:ss format.
>
> **start\_date** `string` *required*
>
> Range start in yyyy-MM-dd HH:mm:ss format.
>
> **api\_token\_name** `string`
>
> Optional non-secret dashboard token name used only to filter analytics; not the API token value.
>
> #### 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 Scrape Analytics Timeline
>
> **Slug:** `MRSCRAPER_GET_ANALYTIC_TIMELINE`
>
> Return time-series scrape activity and success metrics for a domain and action over a time range.
>
> #### Input Parameters
>
> **action** `string`
>
> Optional custom-scraper action filter, such as create, rerun, bulk, or fetch HTML; omit to aggregate all actions.
>
> **domain** `string` *required*
>
> Domain to aggregate, without a URL path (for example example.com).
>
> **end\_date** `string` *required*
>
> Range end in yyyy-MM-dd HH:mm:ss format.
>
> **start\_date** `string` *required*
>
> Range start in yyyy-MM-dd HH:mm:ss format.
>
> **api\_token\_name** `string`
>
> Optional non-secret dashboard token name used only to filter analytics; not the API token value.
>
> #### 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 Scrape Result
>
> **Slug:** `MRSCRAPER_GET_RESULT`
>
> Retrieve the current status and output for one accessible scrape result by ID.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0 per result lookup
>
> #### Input Parameters
>
> **result\_id** `string` *required*
>
> Result UUID returned by a create or rerun operation.
>
> #### 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] Heal Manual Scraper
>
> **Slug:** `MRSCRAPER_HEAL_MANUAL_SCRAPER`
>
> Ask MrScraper to repair an existing manual scraper workflow that no longer matches its target site.
>
> #### Input Parameters
>
> **scraper\_id** `string` *required*
>
> UUID of the manual scraper workflow to inspect and repair.
>
> #### 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] List Scrape Results
>
> **Slug:** `MRSCRAPER_LIST_RESULTS`
>
> List scrape results for the connected account with filtering, sorting, and agent-controlled pagination.
>
> #### Input Parameters
>
> **end\_at** `string`
>
> Inclusive end date/time for date\_range\_column.
>
> **search** `string`
>
> Text to search across result columns.
>
> **start\_at** `string`
>
> Inclusive start date/time for date\_range\_column.
>
> **page\_size** `integer`
>
> Maximum results to return in this page (1-100).
>
> **sort\_field** `string`
>
> Provider result field to sort by, such as createdAt.
>
> **sort\_order** `string ("ASC" | "DESC")`
>
> Ascending or descending sort order.
>
> **next\_cursor** `string`
>
> Continuation cursor returned by a previous call; omit for the first page.
>
> **date\_range\_column** `string`
>
> Result date field constrained by start\_at and end\_at.
>
> #### 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] Rerun AI Scraper
>
> **Slug:** `MRSCRAPER_RERUN_AI_SCRAPER`
>
> Run an existing AI scraper configuration against a new URL, with optional map crawl controls.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.995 per 1,000 tokens used
>
> **Discount:** 5
>
> #### Input Parameters
>
> **url** `string` *required*
>
> New HTTP or HTTPS URL to process with the existing scraper.
>
> **limit** `integer`
>
> Optional maximum extracted entries for a map scraper (1-100000); omit to use the provider default of 1000.
>
> **max\_depth** `integer`
>
> Optional maximum link depth for a map scraper (0-5); omit to use the provider default of 2.
>
> **max\_pages** `integer`
>
> Optional maximum pages for a map scraper (1-1000); omit to use the provider default of 50.
>
> **scraper\_id** `string` *required*
>
> AI scraper UUID returned by a prior AI scrape.
>
> **exclude\_patterns** `array`
>
> URL regex patterns to exclude when rerunning a map scraper.
>
> **include\_patterns** `array`
>
> URL regex patterns to include when rerunning a map scraper.
>
> #### 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] Rerun Manual Scraper
>
> **Slug:** `MRSCRAPER_RERUN_MANUAL_SCRAPER`
>
> Run an existing saved manual scraper workflow against a new URL.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> New HTTP or HTTPS URL to process with the saved workflow.
>
> **scraper\_id** `string` *required*
>
> UUID of an existing manual scraper saved in MrScraper.
>
> #### 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
