Apify
Run MrScraper as Apify Actors to unblock pages, extract detail and listing data, and pipe results into the Apify platform.
Apify Integration
Apify is a cloud platform for running, scheduling, and scaling web scraping and automation programs called Actors. Actors run in managed containers, store their output in datasets, and can be triggered from the Apify Console, the Apify API, the CLI, or from other Actors in a workflow.
MrScraper publishes its scraping engine as Actors on the MrScraper Apify profile, so you can use MrScraper's unblocking and AI extraction without managing proxies, browsers, or infrastructure yourself.
Available Actors
MrScraper PDP
Unblock and extract structured data from detail pages — products, articles, hotels, job postings, properties, and more.
MrScraper Listing
Extract data from listing and category pages with AI, including pagination across multiple pages.
MrScraper Unblocker
Retrieve raw HTML from any page, bypassing anti-bot protection and geo restrictions.
Why Use MrScraper on Apify?
- No API token required: Billing and authentication are handled by your Apify account, so you don't need a separate MrScraper API token.
- Managed infrastructure: Apify handles the runtime, retries, storage, and scheduling.
- Built-in storage: Results land in an Apify dataset that you can export as JSON, CSV, XLSX, or push to other integrations.
- Composable: Chain the Actors together or with any other Actor in the Apify Store.
- Pay per event: You're charged for what each run actually consumes rather than for a fixed subscription.
Choosing an Actor
Use Unblocker when you want the raw HTML and will parse it yourself. Use PDP when you want structured fields from a single item page. Use Listing when you want many items from a category, search, or directory page.
Prerequisites
Before you start, make sure you have:
- An Apify account.
- An Apify API token (only needed for API or CLI runs).
You do not need a MrScraper account or API token to run these Actors — usage is billed through Apify.
Running an Actor
Open the Actor
Go to the MrScraper profile on Apify and open the Actor you want to run, or search for MrScraper in the Apify Store.
Configure the input
Fill in the input fields in the Console form, or switch to the JSON tab to paste an input object directly. Each Actor's fields are documented on its own page.
Start the run
Click Start. The run log streams live, and results appear in the Dataset tab as they're produced.
Export or forward the results
Export the dataset as JSON, CSV, or XLSX from the Console, fetch it through the Apify API, or connect it to a webhook or another Actor to continue the pipeline.
Running via the Apify API
You can start any of the Actors with a single HTTP request. Replace <APIFY_API_TOKEN> with your token and <ACTOR_NAME> with mrscraper-pdp, mrscraper-listing, or mrscraper-unblocker.
curl -X POST "https://api.apify.com/v2/acts/mrscrapercom~<ACTOR_NAME>/runs?token=<APIFY_API_TOKEN>" \
-H "Content-Type: application/json" \
-d '{
"urls": [{ "url": "https://www.ebay.com/itm/236604718789" }],
"category": "product"
}'To run the Actor and wait for the dataset items in one call, use the run-sync-get-dataset-items endpoint:
curl -X POST "https://api.apify.com/v2/acts/mrscrapercom~<ACTOR_NAME>/run-sync-get-dataset-items?token=<APIFY_API_TOKEN>" \
-H "Content-Type: application/json" \
-d '{
"urls": [{ "url": "https://www.ebay.com/itm/236604718789" }],
"category": "product"
}'Running via the Apify CLI
npm install -g apify-cli
apify login
apify call mrscrapercom/mrscraper-pdp --input-file input.jsonShared Input Options
The MrScraper Actors share a common set of proxy and output options. Individual Actor pages list the fields each one supports.
Proxy options
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
proxy_use_proxy | boolean | No | true | Route requests through residential and mobile IPs to avoid blocks. |
proxy_proxy_country | string | No | "" | Country code for geo-targeted requests (e.g. US, UK, SG). Leave empty to let MrScraper choose. |
proxy_bypass_proxy | boolean | No | true | Block images, fonts, and stylesheets to reduce bandwidth and speed up the run. |
Browser rendering options
Available on the PDP and Unblocker Actors, for pages that build their content with JavaScript.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
browser_rendering_enabled | boolean | No | false | Load the page in a full browser instead of a plain HTTP request. |
browser_rendering_wait_for_selector | string | No | "" | CSS selector to wait for before extracting, for content that loads late. |
browser_rendering_listen_network | boolean | No | false | Capture network requests made while the page loads. PDP only. |
Rendering costs extra
Browser rendering and network listening are billed as separate events on top of the standard request. Leave them off unless the page genuinely needs them — start with a plain request and enable rendering only if the data is missing.
Output options
Available on the PDP and Listing Actors.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
output_html | boolean | No | false | Include the raw HTML of the page alongside the extracted data. |
output_markdown | boolean | No | false | Include a Markdown rendering of the page, useful for feeding into LLMs. |
Pricing
All three Actors use Apify's pay-per-event model, so cost scales with what a run actually does rather than with compute time alone.
| Actor | Starting price |
|---|---|
| MrScraper Unblocker | From $2.00 / 1,000 standard requests |
| MrScraper PDP | From $3.00 / 1,000 standard requests |
| MrScraper Listing | From $100.00 / 1,000 standard requests |
Runs can also incur these event charges:
- Standard request: Charged per URL processed.
- Browser rendering: Charged when
browser_rendering_enabledis on. - Network listening: Charged when
browser_rendering_listen_networkis on. - Time-based cost: Charged per 30-second interval of run time.
- Bandwidth cost: Charged per MB transferred.
- AI token cost: Charged based on tokens consumed by AI extraction.
Check the live pricing
Prices above are starting rates and Apify Store discounts vary by subscription tier. Check the Actor's page on Apify for the current rates before running at volume.
Enterprise and Custom Actors
For custom integrations, higher volumes, or Actors tailored to a specific site, contact the MrScraper team through mrscraper.com.