El Palacio de Hierro Mexico Scraper & API

Extract El Palacio de Hierro Mexico products and prices in MXN for price monitoring, promotion analysis and product catalog research. Search one term or multiple terms and export real product records as JSON, CSV or Excel through Apify.

Independent tool by Latin America Data. Not affiliated with or endorsed by El Palacio de Hierro Mexico. Source: https://www.elpalaciodehierro.com/.

What can you use it for?

• Compare matching products across Mexican retailers using identifiers, brands and original product URLs.
• Build your own price history by scheduling repeated runs and storing dated records.
• Track advertised promotions separately from ordinary prices.
• Research product assortment and catalog changes without manually copying listings.

Quick start

For a low-cost check:

{"term":"perfume","maxItems":3,"maxRuntimeSecs":90}

To search without an explicit result or page limit:

{"searchTerms":["perfume","cafe"],"maxRuntimeSecs":600}

No proxy configuration is required. Omit maxItems and maxPages to continue until source exhaustion, the runtime budget or your Apify spending limit. The default runtime budget is 240 seconds and can be increased to 7,200 seconds. A time budget is not a guarantee of full-catalog coverage.

Input

Field	Meaning
term	Product, brand or category to search.
searchTerms	Optional list of up to 100 searches; replaces term.
maxItems	Optional total number of unique products across all searches. No default cap.
maxPages	Optional pages per search. No default cap.
startPage	Starting page, default 1.
maxRuntimeSecs	Run safety budget, default 240; maximum 7,200 seconds.

Output

The dataset contains only genuine product records: product_id, sku, title, brand, price, list_price, currency, discount_percent, available, availability_scope, promotions, image_url, source_url, search_term, page, rank, country, source, status and scraped_at. Optional fields may be null. Do not interpret null as zero or unavailable.

Products are saved progressively by page and deduplicated across searches. Repeated products are charged once per run. Source rankings and totals can change while scraping.

RUN_SUMMARY records counts, pagination, stop reason, completeness and non-chargeable performance information. DIAGNOSTICS contains any empty, blocked or failed-run explanation, separately from the billable dataset.

• success: valid products returned. Check complete and stop_reason for limits.
• no_results: the source explicitly confirmed an empty search; zero product charges.
• partial: earlier valid products were retained after a later error or safety limit.
• blocked / failed: no products could be delivered. The run fails visibly instead of pretending that access denial is an empty catalog.

Pricing

USD 0.003 per delivered product, plus Apify platform usage paid by the customer. 1,000 delivered products cost USD 3.00 in result fees, excluding compute, storage and automatic proxy usage. Empty searches and diagnostic records incur no result fee, but platform usage can still apply. Set a maximum total charge in Apify to control spending.

Coverage and limitations

Prices come from the storefront's public Constructor search service. price is the advertised selling price, or the minimum for a ranged product; price_max is the maximum. Neither guarantees that every size or color has that price. This release returns listing-level products, not every SKU variant. Extra fields include size, gender, collection, product_type, categories, availability_status and reported_quantity when disclosed. Availability and quantities describe the online search index, not branch-level inventory or guaranteed checkout availability. Unknown availability remains null. Loyalty coins and financing offers remain in promotions, not computed as cash discounts.

The source contract is Constructor's public JSON search API, with 52 products per page. The public search-index identifier is also exposed by the storefront. The actor verifies the requested term, page and page size against each response. No browser is required for the validated route. The earlier HTML route was rejected after cloud access tests; it is not the production route.

The scraper preserves earlier output if a later page is blocked. It does not bypass logins, retrieve private customer data, fabricate products or promise access during every site outage. Unknown HTML is treated as an error, never automatically as no results.

API and scheduled monitoring

Use Apify's API integration to start this Actor, retrieve its dataset, or schedule repeated searches. Each product includes its original URL and collection timestamp for auditing. Respect source terms, applicable law and responsible request rates. This Actor does not provide historical prices from before your runs.