Delcampe API & Scraper
The Delcampe API turns delcampe.net, the Belgian marketplace where collectors buy and sell stamps, postcards, coins and banknotes, trading cards, old paper and photographs, into JSON in four actions.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
search finds listings for sale now or already sold, by words and by category (as an id or as the category path an item gives you), sale type (fixed price, auction, auction with bids, auction without bids, auction-house lots), price in euros, seller country or continent, one seller's shop, free shipping and discounted listings, sorted newest first, ending soonest, by price or by title, from 12 to 480 rows a page. Every row has the item number, title, sale type, price and currency, bid count on auctions, whether the seller is a professional or a private individual, and the image. item returns one listing in full: the price in the listing's own currency, whether it is an asking price, a starting price, the current bid or the final price, every bid with its amount and time, purchases, start and end time in UTC, the buyer's platform fee, each shipping zone with its countries, methods and costs, the description, the category path and every large image, plus the seller's rating, location, languages and member-since date. seller returns a seller's ratings over the last 12 months and since registration with transaction counts and the latest feedback, and categories walks the category tree with ids. One ReefAPI key, the standard { ok, data, meta, error } envelope, no Delcampe account.
One query, filtered thirteen ways — Delcampe's own counts on 2026-10-15
The number of listings Delcampe reported for the search 'napoleon' with each filter, measured in one run. The API passes each filter to the site and returns the site's own count in meta.total.
| filter | listings |
|---|---|
| none (for sale now) | 210,641 |
| category Stamps | 126,826 |
| fixed price only | 92,545 |
| auctions only | 117,981 |
| auctions that already have bids | 54 |
| auction-house lots | 115 |
| sold listings | 166,603 |
| price 10 to 20 EUR | 28,376 |
| sellers in Belgium | 8,468 |
| free shipping | 5,183 |
| discounted listings | 13,324 |
Counts above about a million are rounded by Delcampe and move as listings come and go; pages stop at 10,000 rows, so narrow a big search with filters.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/delcampe/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "napoleon",
"category_id": 30001,
"limit": 60
}
}{
"ok": true,
"meta": {
"api": "delcampe",
"endpoint": "search",
"mode": "live",
"latency_ms": 616.1,
"record_count": 60,
"bytes": 516538,
"cache_hit": false,
"total": 126746,
"total_is_exact": false,
"page": 1,
"limit": 60,
"last_page": 167,
"has_more": true,
"adverts_dropped": 3,
"filters_applied": {
"query": "napoleon",
"category_id": 30001,
"status": "ongoing",
"sort": "newest"
},
"display_currency": "EUR",
"timezone": "Europe/Berlin",
"price_basis": "the listing's price before shipping and the buyer's platform fee",
"upstream_requests": 1,
"warnings": [
"the source counts 126746 results but pages stop at 10000 rows"
],
"charged_credits": 3,
"version": "1.0.0",
"request_id": "8e55802c9ef44138",
"queue_ms": 1.4,
"fetched_at": "2026-10-15T17:02:52.199Z"
},
"data": {
"rows": [
{
"item_id": "415597932",
"url": "https://www.delcampe.net/en_GB/collectables/stamps/monaco/unused-stamps-8/monaco-n-2445-neuf-sans-charniere-napoleon-et-princes-grimaldi-legion-d-honneur-415597932.html",
"title": "Monaco - N° 2445 ** - Neuf sans charnière - Napoléon et princes Grimaldi - Légion d’honneur",
"sale_type": "fixed_price",
"price": 1.1,
"currency": "EUR",
"price_is_converted": false,
"price_converted": null,
"price_converted_currency": null,
"price_before_discount": null,
"discount_label": null,
"discount_percent": null,
"bid_count": null,
"seller_kind": "professional",
"is_new": true,
"image": "https://www.delcampe.net/static/img_thumb/auction/000/415/597/932_001.jpg",
"image_large": "https://www.delcampe.net/static/img_large/auction/000/415/597/932_001.jpg"
},
{
"item_id": "415596100",
"url": "https://www.delcampe.net/en_GB/collectables/stamps/monaco/unused-stamps-8/monaco-n-2442-neuf-sans-charniere-sacre-de-napoleon-ier-415596100.html",
"title": "Monaco - N° 2442 ** - Neuf sans charnière - Sacre de Napoléon Ier",
"sale_type": "fixed_price",
"price": 4.2,
"currency": "EUR",
"price_is_converted": false,
"price_converted": null,
"price_converted_currency": null,
"price_before_discount": null,
"discount_label": null,
"discount_percent": null,
"bid_count": null,
"seller_kind": "professional",
"is_new": true,
"image": "https://www.delcampe.net/static/img_thumb/auction/000/415/596/100_001.jpg",
"image_large": "https://www.delcampe.net/static/img_large/auction/000/415/596/100_001.jpg"
},
{
"item_id": "2651486603",
"url": "https://www.delcampe.net/en_GB/collectables/stamps/france/1853-1860-napoleon-iii/france-1854-n-12a-napoleon-iii-second-empire-5c-vert-jaune-sur-verdatre-legende-empire-franc-non-dentele-2651486603.html",
"title": "FRANCE 1854 N°12A (*) (NAPOLÉON III. SECOND EMPIRE. 5C VERT-JAUNE SUR VERDÂTRE. LÉGENDE EMPIRE FRANC. NON DENTELÉ)",
"sale_type": "fixed_price",
"price": 101.74,
"currency": "EUR",
"price_is_converted": false,
"price_converted": null,
"price_converted_currency": null,
"price_before_discount": null,
"discount_label": null,
"discount_percent": null,
"bid_count": null,
"seller_kind": "private",
"is_new": true,
"image": "https://www.delcampe.net/static/img_thumb/auction/002/651/486/603_001.jpg",
"image_large": "https://www.delcampe.net/static/img_large/auction/002/651/486/603_001.jpg"
}
]
}
}What the Delcampe API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Delcampe listings — for sale now or already sold — by words, category, sale type (fixed price / auction / auction house), price in EUR, seller country or continent, one seller's shop, free shipping and discounted listings. Up to 480 rows a page. | Pricing teams call search to search Delcampe listings. | query, category_id, category_path, sale_type, status, ... |
| item | One listing in full: the listing's own price and currency, sale type, status (ongoing / ended) and whether it sold, every bid (bidder alias, amount, time), purchases, start and end time in UTC, buyer platform fee, shipping zones with each zone's countries, methods and costs, description, category path, all large images, and the seller (rating, location, languages, member since). Give item_id or url. | Marketplace operators call item to get one listing in full. | item_id, url |
| seller | A seller's public profile: professional or private, rating over the last 12 months and since registration with transaction counts, member since, last connection, location, languages, and the latest feedback received (score, comment, date). | Catalog enrichment teams call seller to get a seller's public profile. | seller_id |
| categories | The category tree, one level at a time: without category_id the top-level categories; with one, its name, path, number of listings and its sub-categories with their ids. | Retail analysts call categories to get the category tree, one level at a time. | category_id |
Call search from your stack
curl -X POST https://api.reefapi.com/delcampe/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"napoleon","category_id":30001,"limit":60}'import requests
r = requests.post(
"https://api.reefapi.com/delcampe/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "napoleon",
"category_id": 30001,
"limit": 60
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/delcampe/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "napoleon",
"category_id": 30001,
"limit": 60
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.delcampe.search with {"query":"napoleon","category_id":30001,"limit":60}.Who uses this API and why
- Price a stamp or coin from real sales: search status sold with the catalogue number and read the final prices.
- Watch auctions closing today: search sale_type auction_with_bids sorted ending_soon, then item for every bid.
- Monitor a dealer's shop: search seller_id for new listings and seller for the rating trend.
- Compare shipping to your country before you bid: item lists every zone's countries and costs.
- Build a category feed: categories gives the tree with ids, search category_id the newest listings in each.
Questions developers ask before integrating
Can I get sold prices?
Yes. search with status sold returns closed sales with the price they sold at (166,603 sold results for 'napoleon' on 2026-10-15), and item on a sold listing gives status ended, sold true, the final price, the purchases with quantity and date, and the end time.
How are auctions shown?
sale_type is fixed_price, auction or auction_house. On an auction, price_is says whether the price is the starting price (no bids) or the current bid, bid_count gives the number of bids, and item lists every bid with the bidder's anonymous label as Delcampe shows it (Bidder #1, Bidder #2), the amount and the time in UTC. On every auction measured, the price equalled the highest bid in the bid list.
Which currency are the prices in?
Almost every Delcampe listing is priced in euros, and item always returns the listing's own price and currency. A few listings are priced in pounds or dollars (2 of 2,442 search rows measured); search marks those rows with price_is_converted and gives Delcampe's approximate euro figure as price_converted, and item gives the original price, for example 850 GBP.
Are shipping costs included?
The listing price excludes shipping and the buyer's platform fee, as on the site. item returns each shipping zone the seller set up with its list of countries and every shipping method with its cost (for example France: letter 1.52 EUR, tracked letter 2.02 EUR; 248 other countries: 2.25 and 5.05 EUR), plus the platform fee (10 % + 0.30 EUR; on a 1,850 EUR coin, 185.30 EUR).
What do I learn about the seller?
Every search row says whether the seller is a professional or a private individual. item gives the seller's id, nickname, rating and number of ratings, country, languages and member-since date. seller adds the rating over the last 12 months and since registration with transaction counts, for example 99 % over 168,456 ratings, and the latest feedback with score, comment and date.
How do I search one category?
Pass category_id from the categories action (30001 Stamps, 30002 Postcards, 30003 Coins & Banknotes, 34439 Modern Collectible Cards) or category_path exactly as an item's breadcrumbs give it, such as stamps/france/18491900. categories without an id lists the top level; with an id it gives the name, path, listing count, parent and sub-categories.
How many results can I page through?
Up to 480 rows a page and 10,000 rows in total per search, the same window as the site. meta.total is Delcampe's own count; has_more and last_page say how far the window reaches.
What is not included?
Anything behind a Delcampe login: bidders' and buyers' nicknames (the site shows them as Bidder #n and Buyer #n), contacting a seller, buying or bidding. Search rows do not carry end times or shipping costs; item does.
What is the Delcampe API?
Delcampe API is a ReefAPI endpoint group for delcampe stamps, postcards, coins and collectables as json: listings for sale or already sold, every bid with its amount and time, shipping costs per zone, and the seller's ratings. It returns live JSON through POST requests under /delcampe/v1.
Is the Delcampe API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Delcampe calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Delcampe login or account?
No login to Delcampe is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Delcampe data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Delcampe API use?
Delcampe actions currently cost 3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Delcampe from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call delcampe actions with the same key, credit pool and JSON envelope used by normal REST requests.