Back to template gallery

Start with JavaScript

Scrape single page with provided URL with Axios and extract data from page's HTML with Cheerio.







Use cases


Web scraping


1// Axios - Promise based HTTP client for the browser and node.js (Read more at
2import axios from 'axios';
3// Cheerio - The fast, flexible & elegant library for parsing and manipulating HTML and XML (Read more at
4import * as cheerio from 'cheerio';
5// Apify SDK - toolkit for building Apify Actors (Read more at
6import { Actor } from 'apify';
7// this is ESM project, and as such, it requires you to specify extensions in your relative imports
8// read more about this here:
9// import { router } from './routes.js';
11// The init() call configures the Actor for its environment. It's recommended to start every Actor with an init().
12await Actor.init();
14// Structure of input is defined in input_schema.json
15const input = await Actor.getInput();
16const { url } = input;
18// Fetch the HTML content of the page.
19const response = await axios.get(url);
21// Parse the downloaded HTML with Cheerio to enable data extraction.
22const $ = cheerio.load(;
24// Extract all headings from the page (tag name and text).
25const headings = [];
26$("h1, h2, h3, h4, h5, h6").each((i, element) => {
27    const headingObject = {
28        level: $(element).prop("tagName").toLowerCase(),
29        text: $(element).text(),
30    };
31    console.log("Extracted heading", headingObject);
32    headings.push(headingObject);
35// Save headings to Dataset - a table-like storage.
36await Actor.pushData(headings);
38// Gracefully exit the Actor process. It's recommended to quit all Actors with an exit().
39await Actor.exit();

Scrape single-page in JavaScript template

A template for scraping data from a single web page in JavaScript (Node.js). The URL of the web page is passed in via input, which is defined by the input schema. The template uses the Axios client to get the HTML of the page and the Cheerio library to parse the data from it. The data are then stored in a dataset where you can easily access them.

The scraped data in this template are page headings but you can easily edit the code to scrape whatever you want from the page.

Included features

  • Apify SDK - toolkit for building Actors
  • Input schema - define and easily validate a schema for your Actor's input
  • Dataset - store structured data where each object stored has the same attributes
  • Axios client - promise-based HTTP Client for Node.js and the browser
  • Cheerio - library for parsing and manipulating HTML and XML

How it works

  1. Actor.getInput() gets the input where the page URL is defined

  2. axios.get(url) fetches the page

  3. cheerio.load( loads the page data and enables parsing the headings

  4. This parses the headings from the page and here you can edit the code to parse whatever you need from the page

    $("h1, h2, h3, h4, h5, h6").each((_i, element) => {...});
  5. Actor.pushData(headings) stores the headings in the dataset


Already have a solution in mind?

Sign up for a free Apify account and deploy your code to the platform in just a few minutes! If you want a head start without coding it yourself, browse our Store of existing solutions.