Soriana Mexico Scraper & API

Extract Soriana 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 Soriana Mexico. Source: https://www.soriana.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":"leche","maxItems":3,"maxRuntimeSecs":90}

To search without an explicit result or page limit:

{"searchTerms":["leche","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

Soriana prices and availability refer to the default public online catalog. This release does not select a postal code or store and must not be used as branch-level inventory. The output explicitly marks availability_scope=default_online_catalog and postal_code=null. Some matching listings explicitly have no public price: they are excluded from charges and listed in DIAGNOSTICS and RUN_SUMMARY.skipped_products as price_not_published. Pagination continues past them. Such searches may deliver fewer priced products than the website's match count; full scans with exclusions report partial coverage. Brand and unit can be null when the listing does not expose them. Package sizes remain in the original product title. Multi-buy, loyalty, coupon and installment conditions remain separate in promotions; they are not subtracted from price.

The source serves Salesforce Commerce Cloud search pages with public product attributes and 24 products per page. Pagination uses the site's search offset and verifies its selected page. Mexican residential access is managed automatically when needed.

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.