ScrapeNinja Live Sandbox

Get started right from your browser: execute scraping requests, both JS and non-JS, submitting the form below.

URL to scrape:

Quick examples: HackerNews basic Forbidden country bypass Linkedin Job Posting Zillow Property auto.de results POST JSON Click & dump JSON Website metadata

Hint: {{ note }}

Evaluate JS Launches real browser. This is 5x slower. Only GET requests are supported with JS evaluation.

Catch subsequent AJAX call (global)

Advanced. Can be used to dump sub-request. See airlines scraper example. Use with caution: bad URL mask will result in timeouts because scraper will be waiting for the AJAX call until the timeout, and won't be able to dump required data! Explore .info.catchedAjax of the ScrapeNinja response to retrieve the dumped request. This is a global handler, you can also specify XHR request catcher per-step (see "Interact with page" sectin below).

Mask for AJAX request url:

Interact with page

Advanced. Interact with page: fill in forms, and click links!

Step #{{idx+1}}:

Selector:

Wait for navigation Activate if the action triggers page redirect.

Dump XHR (ajax) request

Mask for XHR request url: Catched XHR response body will be available within .info.log events array from the returned ScrapeNinja response (find this particular event by filtering let xhr = body.info.log.find(e => e.type == 'xhr' && e.stepIdx == {{idx+1}})).

Set value

delete step

New Step [+]

Block Images Do not wait for images to load.

Block CSS and fonts Do not wait for css to load.

HTTP Method

Proxy geo

Custom Proxy URL:

Custom Proxy

Number of retries

Wait For Selector (JS evaluation):

Wait for DOM selector to appear

Headers to send (one per line)

HTTP statuses not expected (one per line)

Response strings not expected (one per line)

Raw POST/PUT body

Examples of valid payloads:

JSON payload: {\"fefe\":\"few\"}
www-encoded payload: key1=val1&key2=val2

Add Content-Type: application/x-www-form-urlencoded to headers in case of www-encoded POST and Content-Type: application/json

Extractor (optional, experimental) Develop your extractor function in realtime in dedicated sandbox

JS function to extract data from scraped HTML/JSON. Function accepts raw input string as a first argument, Cheerio HTML parser instance as a second argument. You don't have to use Cheerio if you don't need it, you can just use regex to get data if you prefer, see Letterbox rating example extractor. Quick Starter for Cheerio extractor:


                        
                          

                          function (input, cheerio) { 

                            let $ = cheerio.load(input); 

                            return { title: $('#title').text().trim() } 

                        }

Grab extracted results from .extractor json property of ScrapeNinja response. Leave empty to parse everything on your side.

Scrape it Scraping.. Save example

Raw ScrapeNinja Response:

Latency: {{ responseLatency }}ms HTTP Status: {{ responseBody.info.statusCode }}

Submit the form to scrape the URL.

{{ responseBodyFormatted }}

Screenshot

Click to open full size in a new tab.

Unescaped target website response

Access it in your code via responseJson.body property. Use {{cmdKey}}+F for a quick search in the response body. Copy&paste this body to Cheerio Sandbox to develop your extractor.

Quick video overview of the sandbox:

Code Generator

Language:

JavaScript

Python

Use the generated code below to run the requests to ScrapeNinja API from your own server.

import fetch from 'node-fetch';

const url = 'https://scrapeninja.p.rapidapi.com/{{sjUrl}}';

const PAYLOAD = {{ payloadString }};

const options = {
  method: 'POST',
  headers: {
    'content-type': 'application/json',
    // get your key on https://rapidapi.com/restyler/api/scrapeninja
    'X-RapidAPI-Key': 'YOUR-KEY',
    'X-RapidAPI-Host': 'scrapeninja.p.rapidapi.com'
  },
  body: JSON.stringify(PAYLOAD)
};

try {
  let res = await fetch(url, options);
  let resJson = await res.json();

  // Basic error handling. Modify if neccessary
  if (!resJson.info || ![200, 404].includes(resJson.info.statusCode)) {
      throw new Error(JSON.stringify(resJson));
  }

  console.log('target website response status: ', resJson.info.statusCode);
  console.log('target website response body: ', resJson.body);
} catch (e) {
  console.error(e);
}

Launching the scraper in your own Node.js environment:

All the code in these instructions has been tested out on Linux Ubuntu and Node.js v16, and will also work on Node.js v14.8, but not lower versions, because of top-level awaits. To make it work on older Node.js versions, wrap the code of try-catch block into (async () => { [CODE GOES HERE] } )();. Check your Node.js version: node -v.

Step 1. Create project folder, initialize empty npm project, and install node-fetch

mkdir your-project-folder && \
  cd "$_" && \
  npm i -g create-esnext && \
  npm init esnext && \
  npm i node-fetch -y

Step 2. Copy&paste the code above

Create new empty file like scraper.js and paste the code to this file.

Step 3. Launch

node ./scraper.js

import requests
import json

url = 'https://scrapeninja.p.rapidapi.com/{{sjUrl}}'

# get your subscription key at https://rapidapi.com/restyler/api/scrapeninja from "Code generator",
# copy and paste it to 'x-rapidapi-key' header below

headers = {
    "Content-Type": "application/json",
    "x-rapidapi-host": "scrapeninja.p.rapidapi.com",
    "x-rapidapi-key": "YOUR-RAPIDAPI-KEY"
}

payload =  {{ payloadStringPython }}

response = requests.request("POST", url, json=payload, headers=headers)

response_json = json.loads(response.text)
print(response.__dict__)
print(response_json)

Launching the scraper in your own Python environment:

All the instructions have been tested on Linux Ubuntu and are using Python v3 (though Python v2 should work perfectly fine, too).

Step 1. Create project folder, setup venv virtual environment

mkdir your-project-folder && \
  cd "$_" && \
  python3 -m venv venv && \
  source venv/bin/activate

Step 2: Install requests library in your virtual environment

python3 -m pip install requests

Step 3. Copy&paste the code above

Create new empty file like scraper.py and paste the code to this file.

Step 4. Launch

python3 ./scraper.py

Why ScrapeNinja.net?

Websites are getting harder to scrape. Web scraping protection evolved from checking user agent and other headers, to checking ip address of requester, and lately — to TLS fingerprint analysis. It is easy to start scraping in any programming language but only specialized solutions can provide the reliable way to scrape data on scale.

ScrapeNinja.net has proven to provide high scraping reliability due to state-of-art real browser TLS fingerprint emulation, rigorous realtime stability monitoring of responses, and advanced tech which allows us to find and rotate best proxies.

FAQ

Is ScrapeNinja.net any better than using Chrome extension XYZ?

Scraping Chrome extensions might be good when getting started, to do some light scraping, but for heavy duty and better performance you'd better use cloud-based solutions like ScrapeNinja.

Why not just use Puppeteer/Selenium to emulate Chrome?

When your Python or Node.js scraper fails to get data, using Puppeteer or Selenium is usually the most obvious alternative. But, these two, while doing wonders in terms of automation and flexibility, are slow, and it is very expensive in terms of hardware resources to keep 'em running on a scale, and it requires a lot of work to support it. UPD May 2022: Real Chrome evaluation is now available in ScrapeNinja via /scrape-js endpoint!

Is ScrapeNinja.net any better than BrightData Web Unlocker?

BrightData is a big player on scraping market, but their pricing is through the roof. It is easy to spend $2k or $3k on scraping via BrightData - and ScrapeNinja is a good affordable alternative.

Project integrations:

RapidAPI page:

Online tools:

cURL to Web Scraper converter:

Contact Us:

Questions, feedback? Order custom scraper, tailored to your needs.

[email protected]

Telegram: @scrapeninja

Get started via RapidAPI