# Lidl Spain Product Catalog Scraper

> Lidl Spain Product Catalog Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.04/call, status unknown (last checked 2026-10-02).

Scrapes and returns structured product listings from Lidl Spain's online catalog, with optional filtering by search query, category, stock status, and sort order.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/lidl?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lidl-spain-product-catalog-scraper-d8384b6d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gbagjhaRO3rpUeviDn1cD

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability lidl-spain-product-catalog-scraper-d8384b6d -d '<json body>'
```

Example prompt: Search Lidl Spain's online catalog for 'aspiradora' products sorted by price ascending, include only in-stock items, and return up to 50 results with their names, brands, and EAN codes.

## When to prefer this

Use this endpoint when you need structured product data from Lidl Spain's online catalog — including names, barcodes, categories, and brands — without building or maintaining your own scraper. Prefer it over generic web scraping tools when you specifically need Lidl Spain catalog data in a clean, normalized format with search and filtering built in. Pay-per-call pricing with no charge on empty/failed runs makes it cost-effective for exploratory catalog scans.

## Known failure modes

- Empty result set if query matches no products (not charged)
- Invalid category name returns no results if it doesn't match Lidl Spain's exact top-level category names
- Rate limiting or scraping blocks from Lidl Spain's website causing failed run (not charged)
- Invalid sort enum value causes request rejection
- Network timeout for large catalog scans with maxResults set to 0

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of matched products and an array of product items, each containing fields such as EAN, IAN, name, brand, country, ERP number, product ID, and top-level category. Failed or empty runs are not billed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "enum": [
    "relevancy",
    "price",
    "price-desc",
    "firstOnlineDate-desc",
    "ratingScore-desc",
    "percentageDiscount-desc"
   ],
   "type": "string",
   "default": "relevancy",
   "description": "Order in which search results are collected."
  },
  "query": {
   "type": "string",
   "default": "",
   "description": "Search product names and brands on Lidl Spain. Leave empty to scan the online catalog."
  },
  "categories": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "default": [],
   "description": "Optional exact top-level category names, such as Bricolaje y jardín or Hogar y decoración. Empty includes all categories."
  },
  "maxResults": {
   "type": "integer",
   "default": 200,
   "minimum": 0,
   "description": "Maximum products across the run. Set 0 to collect all available products."
  },
  "inStockOnly": {
   "type": "boolean",
   "default": false,
   "description": "Include only products marked available online."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "ean": null,
    "ian": null,
    "name": null,
    "brand": null,
    "country": null,
    "erpNumber": null,
    "productId": null,
    "categoryLvl0": null
   }
  ],
  "product": "lidl"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lidl-spain-product-catalog-scraper-d8384b6d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)