Liverpool Mexico Products & Prices Scraper

Here is one real result, with every field the actor returns:

{
  "productName": "Apple iPhone 17 6.3 pulgadas Super Retina XDR",
  "brand": "APPLE",
  "priceAmount": 24998.3,
  "originalPrice": 26314,
  "currency": "MXN",
  "discountPct": 5,
  "onSale": true,
  "sku": "1186186221",
  "skuId": "1186093697",
  "skuName": "Apple iPhone 17 6.3 pulgadas Super Retina XDR",
  "color": "Negro",
  "size": "512 GB",
  "variantCount": 5,
  "rating": 4.9,
  "reviewCount": 81,
  "availability": "IN_STOCK",
  "inStock": true,
  "category": "Regreso a Clases > Tecnología > Celulares|LP",
  "department": "632",
  "productType": "Soft Line",
  "seller": "liverpool",
  "sellerType": "liverpool",
  "isMarketplace": false,
  "isImported": false,
  "crossBorder": false,
  "clickAndCollect": false,
  "homeDelivery": false,
  "productUrl": "https://www.liverpool.com.mx/tienda/pdp/producto/1186186221",
  "imageUrl": "https://sp632.liverpool.com.mx/i/1186093697.jpg",
  "keyword": "iphone",
  "source": "Liverpool Mexico",
  "observedAt": "2026-08-10T14:34:40.816Z"
}

The most complete Liverpool Mexico scraper available. It returns every field the product listing exposes (name, brand, current and original price in MXN, discount, SKU and variant identifiers, rating, review count, availability, and full category path), plus derived commerce flags (onSale, inStock, marketplace vs first-party seller, imported and cross-border, click-and-collect and home delivery), and it accepts keywords or full search URLs so you can target exactly the products you need.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor searches Liverpool (liverpool.com.mx), one of Mexico's largest department stores, for the keywords or search URLs you pass, paginates through the matching products, and writes one normalized record per product to the run's dataset. Prices are returned as numbers in MXN with the discount computed, each product is tagged with the keyword that produced it, and missing source values are returned as null. Commerce flags let you tell first-party Liverpool inventory from marketplace sellers and see fulfillment options at a glance.

Data covers products listed on liverpool.com.mx, including both Liverpool's own catalog and its marketplace.

Quickstart

Open the actor, paste this into the input, and press Run. It returns up to 10 products matching the keyword.

{
  "keywords": ["iphone"],
  "maxProducts": 10
}

keywords accepts plain search terms (for example tenis nike, licuadora) or full Liverpool search URLs. Every input is optional; with an empty input the actor uses the prefilled keyword.

Input reference

Field	Type	Required	Default	Description
keywords	string[]	no	["iphone"]	One or more search terms (for example iphone, tenis nike, licuadora) or full Liverpool search URLs. One run searches every item in the list; each product is tagged with the keyword that produced it.
maxProducts	integer	no	10	Maximum products to collect across all keywords. Free Apify plans are capped at 10 per run.

Output reference

One dataset item per product. Types: string, number, integer, boolean, or null when the source value is absent.

Field	Type	Description
productName	string	Product title.
brand	string	Brand name, or null.
priceAmount	number	Current selling price in MXN.
originalPrice	number	List (pre-discount) price in MXN, or null.
currency	string	Always MXN.
discountPct	integer	Discount percent off the original price, or null.
onSale	boolean	true when the current price is below the original, else false or null.
sku	string	Liverpool product SKU (unique per product).
skuId	string	Selected variant SKU ID, or null.
skuName	string	Selected variant name, or null.
color	string	Variant color, or null.
size	string	Variant size or capacity, or null.
variantCount	integer	Number of variants for the product, or null.
rating	number	Average customer rating, or null.
reviewCount	integer	Number of customer reviews, or null.
availability	string	Raw availability code, for example IN_STOCK, or null.
inStock	boolean	true when availability is IN_STOCK, else false or null.
category	string	Full breadcrumb category path.
department	string	Liverpool department code, or null.
productType	string	Product type label, or null.
seller	string	Seller name (liverpool or the marketplace seller).
sellerType	string	liverpool for first-party, marketplace for third-party.
isMarketplace	boolean	true when sold by a marketplace seller.
isImported	boolean	true when flagged as an imported product.
crossBorder	boolean	true when flagged as a cross-border product.
clickAndCollect	boolean	true when click-and-collect pickup is offered.
homeDelivery	boolean	true when home delivery is offered.
productUrl	string	Canonical product page URL.
imageUrl	string	Primary product image URL.
keyword	string	The keyword or URL that produced this product.
source	string	Always Liverpool Mexico.
observedAt	string	ISO 8601 timestamp of when the record was collected.

On a failed run the actor writes a single item with a populated error field (and the keyword and source context) instead of product fields.

Example output record

Real record from a live run (input {"keywords":["iphone"],"maxProducts":10}):

{
  "productName": "Apple iPhone 16 6.1 pulgadas Super Retina XDR",
  "brand": "APPLE",
  "priceAmount": 17499,
  "originalPrice": 18420,
  "currency": "MXN",
  "discountPct": 5,
  "onSale": true,
  "sku": "1163567866",
  "skuId": "1163057502",
  "skuName": "APPLE IPHONE 16, 128 GB, NEGRO",
  "color": "Negro",
  "size": "128 GB",
  "variantCount": 5,
  "rating": 4.9,
  "reviewCount": 223,
  "availability": "IN_STOCK",
  "inStock": true,
  "category": "Regreso a Clases > Tecnología > Celulares|LP",
  "department": "632",
  "productType": "Soft Line",
  "seller": "liverpool",
  "sellerType": "liverpool",
  "isMarketplace": false,
  "isImported": false,
  "crossBorder": false,
  "clickAndCollect": false,
  "homeDelivery": false,
  "productUrl": "https://www.liverpool.com.mx/tienda/pdp/producto/1163567866",
  "imageUrl": "https://sp632.liverpool.com.mx/i/1163057502.jpg",
  "keyword": "iphone",
  "source": "Liverpool Mexico",
  "observedAt": "2026-08-10T14:34:40.816Z"
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~liverpool-mexico-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"keywords":["iphone","tenis nike"],"maxProducts":50}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~liverpool-mexico-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"keywords":["licuadora"],"maxProducts":200}'

Apify CLI:

apify call scrapers_lat/liverpool-mexico-scraper \
  --input '{"keywords":["laptop"]}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per product returned (result event). See the pricing tab for the current per-result price.
• No charge on failure. If a search errors or no keyword is provided, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 products per run. Upgrade for higher maxProducts.

FAQ and troubleshooting

A run returned 0 records. Why? The keyword matched no products, or the search URL was invalid. Try a broader term. Zero-result runs are not charged.

How do I tell Liverpool inventory from marketplace sellers? Use sellerType (liverpool or marketplace) or the isMarketplace boolean. The seller field names the actual seller.

What currency are prices in? All prices are in Mexican pesos (MXN), as stated in the currency field.

How is the discount calculated? discountPct is the percentage off the originalPrice. onSale is true whenever the current priceAmount is below the originalPrice.

Can I pass a full search URL instead of a keyword? Yes. Any entry in keywords can be a plain term or a full Liverpool search URL.

Is this an official Liverpool tool? No. This actor is independent and has no affiliation with Liverpool. It reads only product data that is publicly available on liverpool.com.mx.

Related scrapers

• MercadoLibre Scraper: Products and prices from MercadoLibre across Latin America.
• Elektra Scraper: Products and prices from Elektra Mexico.
• Walmart Product Scraper: Products and prices from Walmart.
• Vivanuncios Mexico Scraper: Classified listings from Vivanuncios Mexico.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with Liverpool. Accesses only publicly available product data from liverpool.com.mx.