GET
Search
/api/ricardo/search
Search Ricardo auctions and fixed-price listings by keyword with filters and pagination
Ricardo API
Ricardo API for Swiss Auction and Marketplace Search, Listing Details, and Categories
Scrappa's Ricardo API returns structured JSON from Ricardo.ch, the largest Swiss online marketplace. Search auctions and fixed-price listings by keyword or category, open any listing for price, bids, end time, condition, images and seller rating, and browse the full category tree. Prices are CHF numbers and dates are ISO 8601 UTC.
500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
4
Endpoints
1,700+
Categories
$0.20
Per 1k requests
Try it now
Make one request. Inspect structured JSON.
Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.
Request preview
Request
curl -X GET "https://scrappa.co/api/ricardo/search?query=velo&limit=3" \
-H "Accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY"
JSON response
{
"success": true,
"data": {
"query": "velo",
"page": 1,
"limit": 3,
"total": 65589,
"has_more": true,
"results": [
{
"position": 2,
"id": "1331859138",
"title": "Mtb Fully SCOTT made in USA ab Service",
"url": "https://www.ricardo.ch/de/a/1331859138/",
"offer_type": "auction_with_buynow",
"condition": "acceptable",
"next_min_bid": 240.0,
"buy_now_price": 280.0,
"currency": "CHF",
"end_date": "2026-10-15T20:17:00Z",
"zip_code": "8314",
"city": "Kyburg"
}
]
},
"meta": { "endpoint_family": "search", "billable": true }
}What you can build
Structured data for real applications. Here are some ideas.
Swiss Price Monitoring
Track asking prices, buy-now prices and minimum next bids for any product or category on the Swiss second-hand market.
Auction Tracking
Follow bid counts and end times of live auctions, and read the final bid of ended auctions.
Seller Reputation Checks
Read the seller rating in percent, location and nickname for any listing before you buy or resell.
Category Catalogs
Walk the full Ricardo category tree and list the newest listings of any category with pagination.
Cross-Market Resale Research
Combine Ricardo with Gumtree, Wallapop and eBay to compare second-hand prices across countries.
Ricardo scraper API
Ricardo API for Swiss auctions, prices, and seller ratings
The Ricardo API is built for price monitoring, resale research and marketplace analytics on Ricardo.ch. Each result includes the id, title, web url, image, offer type, condition, minimum next bid, buy-now price, bid count, end date, seller and location. The listing endpoint adds the description as HTML and plain text, all images, shipping options, attributes and the seller rating in percent.
Search by keyword or category with auctions-only and CHF price range filters.
Page through results with a page number from 1 to 50 and up to 100 results per page.
Read bids, end time and condition for auctions, and the final bid of ended auctions.
Get the seller rating in percent and the seller location for every listing.
Choose German or French labels with the language parameter.
Choose the right Ricardo API endpoint
Use Search for keyword coverage
Search any keyword and narrow it with a category, an auctions-only switch and a CHF price range. Every result has a stable id and a public web url.
Open Ricardo Search API docsUse Category Listings for catalogs
Pass a category number to list its listings page by page. Use leaf or child categories such as Velos for the best results.
Open Ricardo Category API docsUse Listing Detail for full records
Open a listing by id to get the current bid, minimum next bid, bid increment, end time, condition, images, shipping options and the seller rating.
Open Ricardo Listing API docsUse Categories to find ids
Read the whole category tree once and filter it by parent or level to find the category number for any product group.
Open Ricardo Categories API docsAvailable endpoints
Everything you need in one API.
GET
Category Listings
/api/ricardo/category
List the listings of one Ricardo category with filters and pagination
GET
Listing Detail
/api/ricardo/listing
Get price, bids, end time, condition, images and seller rating of one listing
GET
Categories
/api/ricardo/categories
Retrieve the Ricardo category tree as a flat list
Scrappa vs ScrapingBee / ScraperAPI
See how Scrappa compares to the official API.
| Feature | Scrappa | ScrapingBee / ScraperAPI |
|---|---|---|
| Ricardo listing data as JSON | Build your own parser | |
| Auction bids and end time | Parse it yourself | |
| Seller rating | ||
| Price per 1k requests | From $0.20 | Varies by credits per request |
| Unified API key | Yes (80+ APIs) | Scraping only |
| Free tier | 500 credits/month | Trial credits |
Ricardo listing data as JSON
Scrappa:
ScrapingBee / ScraperAPI:
Build your own parser
Auction bids and end time
Scrappa:
ScrapingBee / ScraperAPI:
Parse it yourself
Seller rating
Scrappa:
ScrapingBee / ScraperAPI:
Price per 1k requests
Scrappa:
From $0.20
ScrapingBee / ScraperAPI:
Varies by credits per request
Unified API key
Scrappa:
Yes (80+ APIs)
ScrapingBee / ScraperAPI:
Scraping only
Free tier
Scrappa:
500 credits/month
ScrapingBee / ScraperAPI:
Trial credits
Key features
Keyword and category search with auctions-only and CHF price range filters
Prices as CHF numbers: minimum next bid, buy-now price, current bid and shipping
Auction bids, bid count and end time in ISO 8601 UTC, with the final bid of ended auctions
Seller rating in percent, nickname and location for every listing
Full category tree with parent and level filters, cached for 24 hours
German and French labels with the language parameter
Frequently asked questions
No. Scrappa is an independent service and is not affiliated with or endorsed by Ricardo. The Ricardo API returns structured JSON from public listings through a Scrappa API key.
Every Scrappa account includes 500 free credits each month. After that, each request costs one credit, which works out to $0.20 to $0.30 per 1,000 requests depending on the credit pack or plan. Failed requests are never charged.
Use the page parameter from 1 to 50 with a limit up to 100. The response returns the total hit count and has_more is true while more pages exist. Ranking shifts between calls, so pages can overlap slightly. A valid empty result is a successful response.
It is the lowest amount a new bid must reach: the starting price while there are no bids, otherwise the current bid plus the bid increment. Prices are CHF numbers.