Ricardo.ch Scraper

Extract Ricardo.ch listing data at scale from search pages and category pages. Collect listing identifiers, pricing, auction status, shipping options, seller references, and timestamps in a clean structured dataset. Useful for price monitoring, market research, and inventory intelligence.

Features

• URL or keyword input - Start from a full Ricardo URL or a keyword search.
• Pagination support - Collect results across multiple pages with configurable limits.
• Clean output - Automatically removes null and empty values from dataset items.
• Structured listing fields - Captures core listing metadata including pricing and seller details.
• Proxy-ready - Supports Apify proxy configuration for reliable collection.

Use Cases

Price Monitoring

Track bid and buy-now prices over time for products, brands, or categories.

Category Intelligence

Analyze activity and supply in category-specific searches.

Seller Research

Build seller-level datasets with listing histories and market behavior signals.

Product Sourcing

Identify active listings and pricing ranges for sourcing opportunities.

---

Input Parameters

Parameter	Type	Required	Default	Description
url	String	No	"https://www.ricardo.ch/de/s/"	Any working Ricardo search URL.
keyword	String	No	"iphone"	Search keyword used when url is not provided.
results_wanted	Integer	No	20	Maximum number of items to collect.
max_pages	Integer	No	5	Maximum pages to paginate.
locale	String	No	"de"	Locale segment for generated links (de, fr, it, en).
proxyConfiguration	Object	No	Apify proxy enabled	Proxy settings for requests.

---

Output Data

Field	Type	Description
id	String	Ricardo listing ID.
title	String	Listing title.
url	String	Listing URL.
image	String	Listing image URL.
categoryId	Number	Ricardo category identifier.
condition	String	Condition key for item state.
bidPrice	Number	Current bid price, when available.
buyNowPrice	Number	Buy-now price, when available.
bidsCount	Number	Number of bids.
hasAuction	Boolean	Whether auction mode is enabled.
hasBuyNow	Boolean	Whether buy-now option exists.
sellerId	String	Seller identifier.
shipping	Array	Shipping methods and costs.
endDate	String	Listing end date/time.
startDate	String	Listing start date/time.
creationDate	String	Listing creation timestamp.
searchPage	Number	Source page index in search results.
searchUrl	String	Source search URL for that record.

---

Usage Examples

Default Search URL

{
  "url": "https://www.ricardo.ch/de/s/",
  "results_wanted": 20,
  "max_pages": 3
}

Keyword Search

{
  "keyword": "iphone",
  "results_wanted": 50,
  "max_pages": 5,
  "locale": "de"
}

Category URL Search

{
  "url": "https://www.ricardo.ch/de/c/o/computer-netzwerk-39091/",
  "results_wanted": 80,
  "max_pages": 4
}

---

Sample Output

{
  "id": "1320674114",
  "title": "iPhone 13 Pro Max",
  "url": "https://www.ricardo.ch/de/a/1320674114/",
  "image": "https://img.ricardostatic.ch/images/f3ffe03d-ec5b-4daf-85b2-db9b25181c87/t_265x200/iphone-13-pro-max",
  "categoryId": 49329,
  "condition": "acceptable",
  "bidPrice": 170,
  "bidsCount": 0,
  "hasAuction": true,
  "isMoneyGuard": true,
  "sellerId": "409293784",
  "shipping": [
    {
      "key": "parcel_b_2kg",
      "cost": 9,
      "zipCode": "3700",
      "city": "Spiez"
    }
  ],
  "endDate": "2026-06-05T17:27:00Z",
  "searchPage": 1,
  "searchUrl": "https://www.ricardo.ch/de/s/"
}

---

Tips for Best Results

Use Valid Ricardo URLs

• Use URLs directly from Ricardo search or category pages.
• Keep the locale in the URL aligned with your target market.

Start Small, Then Scale

• Test with results_wanted: 20 first.
• Increase max_pages and result count after validation.

Use Proxy for Long Runs

• Keep proxy enabled for larger runs to reduce request failures.

---

Integrations

Connect your dataset with:

• Google Sheets - Reporting and quick analysis.
• Airtable - Listing databases and tracking.
• Make - Scheduled automation flows.
• Zapier - Trigger downstream workflows.
• Webhooks - Push results to custom systems.

Export Formats

• JSON - API and developer workflows.
• CSV - Spreadsheet analysis.
• Excel - Business reporting.

---

Frequently Asked Questions

Can I use either URL or keyword?

Yes. If url is provided, it is used first. If not, keyword is used.

Does this support pagination?

Yes. Use max_pages and results_wanted to control depth and volume.

Why are some optional fields missing?

Fields not provided by a listing are removed to keep output clean.

Can I scrape category pages directly?

Yes. Provide a category URL in url.

Is proxy required?

Not always, but recommended for consistency on larger runs.

---

Support

For issues or feature requests, use the Apify Console issue and support channels.

Resources

• Apify Documentation
• Apify API Reference

---

Legal Notice

This actor is intended for lawful data collection. You are responsible for complying with Ricardo terms and all applicable laws in your jurisdiction.