APIs / Marketplaces / Ricardo
1 credit per call4 endpoints
Ricardo API
Get Ricardo data as structured JSON with one API key: search, listing, categories and category. Free credits every month.
curl "https://api.perceptlayer.com/v1/ricardo/categories?language=de" \
-H "X-API-Key: $API_KEY"Playground
Run this API
curl "https://api.perceptlayer.com/v1/ricardo/categories?language=de" \
-H "X-API-Key: $API_KEY"Ricardo · 4 endpoints
Endpoints
Every endpoint takes the same key. Open one for its parameters and an example request.
| Endpoint | Required parameters | Cost |
|---|---|---|
GET/v1/ricardo/categories | language+2 optional | 1 credit |
GET/v1/ricardo/category | category_idpagelimitauction_onlylanguage+2 optional | 1 credit |
GET/v1/ricardo/listing | idlanguage | 1 credit |
GET/v1/ricardo/search | querypagelimitauction_onlylanguage+3 optional | 1 credit |
Overview
About the Ricardo API
What you can get
The Ricardo API returns search, listing, categories and category as clean JSON. Each successful call costs one credit, and calls that fail are free.
More marketplaces APIs
Use cases
Track competitor prices and stock
Use the Ricardo API to track competitor prices and stockEnrich your product catalogue
Use the Ricardo API to enrich your product catalogueResearch sellers and categories
Use the Ricardo API to research sellers and categoriesFAQ
Questions
How much does the Ricardo API cost?
Each successful call costs one credit. New accounts get free credits every month, and credit packs bring the price down as you scale.
What format are responses in?
Every endpoint returns JSON, with no HTML parsing on your side.
Do I need a separate key for Ricardo?
No. One key works for every API in the catalogue.
Try the Ricardo API with 1,000 free credits
No credit card. Failed calls are never billed.