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/premium Proxy URL:

Read more about premium ScrapeNinja proxies. You can also specify your own proxy in the input above.

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

cURL

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 subscription key at https://rapidapi.com/restyler/api/scrapeninja/playground/apiendpoint_e0ae6b61-8bfc-4803-b1cd-0853fbe21fb5 from "Code snippets"
    '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/playground/apiendpoint_e0ae6b61-8bfc-4803-b1cd-0853fbe21fb5 from "Code snippets",
# 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

# get your subscription key at https://rapidapi.com/restyler/api/scrapeninja/playground/apiendpoint_e0ae6b61-8bfc-4803-b1cd-0853fbe21fb5 from "Code snippets",
# copy and paste it to 'x-rapidapi-key' header below
{{ curlCommand }}

Running the cURL Command:

Copy the command and run it in your terminal to execute the request.

Sandbox FAQ

What is the ScrapeNinja Sandbox?

The ScrapeNinja Live Sandbox is an online tool designed to swiftly test the scraping capabilities of a specific target website using the ScrapeNinja Scraping API. It eliminates the need for coding or setting up a local environment. Our goal in creating the Sandbox was to simplify the process of exploring how to scrape a specific website, test various proxy countries for that target, and later bootstrap your project faster with the code generation feature provided by the Sandbox.

Is the ScrapeNinja Sandbox a paid service?

While the ScrapeNinja API operates on a subscription model, offering both free and paid plans, the ScrapeNinja Sandbox is currently available for free. This allows you to fully test its capabilities without any subscription. We hope you find the Sandbox a valuable tool for exploring the ScrapeNinja API.