medimops
momox's German second-hand media shop medimops.de as JSON: look a used book up by ISBN or a disc or game by EAN and get a EUR price and a real unit count for every condition grade in stock.
/medimops/v1/search3 creditsSearch or browse medimops.de (Germany, prices in EUR) and get one row per product with its full condition ladder attached: every grade medimops has in stock (New, Like New, Very Good, Good, Acceptable) with that grade's own EUR price and unit count. Also the barcode lookup: an ISBN-13 or a 13-digit EAN as `query` returns exactly that product. Filters: category shelf, condition grades, format, price band, German FSK age rating, contributor shelf, include products with no copy in stock; 6 sort orders. The response carries medimops's uncapped facet counts next to its total (capped at 10,000), the exact-match flag and a warning for anything the site dropped.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Free-text search over the whole catalogue — title, author, series, publisher. ALSO the barcode lookup: an ISBN-13 or a full 13-digit EAN returns exactly one row (measured: 9783551551672 -> 1 row, 4010324028952 -> 1 row, 0045496420468 -> 1 row). An ISBN-10 or an EAN with its leading zero stripped returns NOTHING at the source, so this engine converts an ISBN-10 to its ISBN-13 before sending and tells you in `meta.query_normalised`. ⚠️ The source DROPS the keyword on every category shelf except the whole catalogue, so `query` and `category` cannot be combined — asking for both is rejected rather than answered with a category dump. Narrow a keyword with `format`, `condition` or `price_min`/`price_max` instead. |
| category | optional | 186606 · 255882 · 284266 · 300992 · 301927 | Browse one medimops.de category shelf instead of searching, by medimops's own numeric category id: the five top shelves are listed above (Bücher 186606, Musik 255882, Filme 284266, Spiele 300992, Software 301927); the `categories` action returns the full medimops tree with every id, name, parent and url. An unknown id is answered with 0 results. Cannot be combined with `query`. |
| condition | optional | New · UsedLikeNew · UsedVeryGood · UsedGood · UsedAcceptable | Keep only products that have a copy in these condition grades — momox's own five tiers. Several allowed and the source really unions them: measured on `q=harry potter`, New alone 653, UsedGood alone 1,264 and ['New','UsedGood'] 1,820 against an unfiltered 2,378. Catalogue-wide on `de`: New 4,918,650 · UsedVeryGood 1,953,408 · UsedGood 1,868,315 · UsedAcceptable 399,668 · UsedLikeNew 231,173. A grade the source does not know (e.g. 'Mint') is silently ignored by it and returns the UNFILTERED catalogue, so unknown grades are rejected here instead. Snake-case spellings (`used_good`, `like_new`) are accepted. |
| format | optional | Taschenbuch · Gebundene Ausgabe · paperback · Audio CD · hardcover · Broschiert · DVD · Sonstige Einbände · Blu-ray · Videospiel · audioCD · Computerspiel · CD-ROM · pocket_book · perfect · Paperback · blu_ray · Comic · spiral_bound · Hardcover | Keep only this physical format, the source's own `medium` token. Measured on `q=harry potter`: 2,378 unfiltered -> 754 Taschenbuch -> 207 DVD -> 96 Audio CD. ⚠️ TWO THINGS THE SOURCE DOES THAT COST YOU ROWS IF NOBODY TELLS YOU. (1) It accepts exactly ONE value: repeating the parameter, comma-joining and pipe-joining were all swallowed and returned the unfiltered total. (2) It carries two parallel vocabularies, so the SAME human label appears under two different tokens — 'Taschenbuch' is both `Taschenbuch` (4,134,492) and `paperback` (1,010,506), and 'Gebundene Ausgabe' is both `Gebundene Ausgabe` (1,114,271) and `hardcover` (272,613). When your value has such a sibling the engine names it in `meta.format_sibling_value` so you can run the second call. An unknown format is answered honestly by the source with 0 results. |
| price_min | optional | 0– | Lowest price in EUR, major units (2 = EUR 2.00). The source's price filter works in whole-euro bands: it is sent as `price=<min>,<max>` and the bands it publishes are 1-2, 2-5, 5-10, 10-20 and 20-max. Measured on `q=harry potter`: 2,378 unfiltered -> 50 in the 1-2 band -> 558 at 20 and above. Use with `price_max`; giving only `price_min` sets the upper end to the source's own `max` keyword. |
| price_max | optional | 0– | Highest price in EUR, major units, same whole-euro banding as `price_min`. Given alone it is sent as `price=0,<max>`. The band applies to the price the storefront shows for the product, which is the price of its best available condition — see `best_price` vs `lowest_price` in the returned rows. |
| age_rating | optional | Freigegeben ohne Altersbeschränkung · Freigegeben ab 6 Jahren · Freigegeben ab 12 Jahren · Freigegeben ab 16 Jahren · Freigegeben ab 18 Jahren · Nicht geprüft · Unbekannt · Unrated · Infoprogramm · Lehrprogramm · Indiziert · G (General Audience) · NR (Not Rated) · R (Restricted) · PG-13 (Parental Guidance Suggested) · X (Mature Audiences Only) · FSK 0 · FSK 12 · FSK 16 · FSK 18 | German age rating (FSK) and its international equivalents, the source's own label verbatim. `de` ONLY — momox-shop.fr publishes no rating facet and asking for one there is rejected rather than silently ignored. Measured on `q=harry potter` / `de`: 2,378 unfiltered -> 2 at 'Freigegeben ab 16 Jahren'; on `q=star wars` the same filter gave 48. Only 193,223 listings carry a rating at all, so this filter cuts hard by design. |
| author | optional | — | Browse one contributor's shelf by the source's own slug — `j-k-rowling`, `coelho-paulo`, `lucinda-riley`. Measured: 409 rows for `j-k-rowling`, 660 for `coelho-paulo`, 0 for a slug that does not exist. ⚠️ TWO measured limits, both enforced rather than hidden. (1) It REPLACES the keyword, it does not narrow it: `from=j-k-rowling` returned the same 409 Rowling rows whether the query was 'harry potter' or 'star wars', so `query` + `author` is rejected. (2) The shelf is ONE FIXED PAGE: page 0, page 1 and page 2 of it, the same shelf with condition=New and the same shelf with sorting=-price all returned the byte-identical 28 rows, so `page`, `condition`, `format`, `price_min`/`price_max`, `age_rating`, `include_unavailable` and `sort` are rejected here instead of being silently dropped — the total still tells you how many the contributor has. Every `search` response lists the top contributor slugs of the current result set under `facets.manufacturer`. |
| include_unavailable = false | optional | — | Include products momox currently has NO copy of. Off by default, exactly like the storefront. It opens the result up a lot and the counts prove the source really applies it: `q=harry potter` 2,378 -> 5,759 and `q=star wars` 4,184 -> 10,000 (the latter hits the source's own 10,000 total ceiling — see `total_is_capped`). |
| sort = relevance | optional | relevance · popularity · price_asc · price_desc · date_asc · date_desc | Row order. Verified to really reorder on `q=harry potter` in one run: `price_desc` opened at EUR 316.00, 313.50, 259.60, 250.50, 249.40 and `date_desc` at four 2026-09-01 titles while `date_asc` opened at 1854-01-01 and 1900-01-01. One honest caveat about `price_asc`: the source sorts it on the CHEAPEST variant, not on the price it shows, and it is not strictly monotonic at every page boundary (measured page 1 max 1.54 <= page 2 min 1.54, but page 2 max 4.79 > page 3 min 1.99). Any word outside this list is silently ignored by the source, so it is rejected here. |
| page = 1 | optional | 1– | Which page of results, 1-based. ⚠️ The source is 0-indexed and answers `page=0`, `page=-1`, `page=abc` and no page at all with the FIRST page, which makes its own `page=1` the SECOND page — this engine does the translation so page 1 really is the first page and nothing is skipped. Page size is VARIABLE: 29, 28, 30, 29, 30, 27, 26 and 8 rows were measured on consecutive pages of one query, so read `page_rows` and `last_page` instead of multiplying. One page past the end the source silently switches to a broader query and reports a different total, so and far past the end it answers with neither rows nor a page count, so a page beyond `last_page` is REFUSED here rather than answered with another query's rows. |
| include_pii = false | optional | — | Accepted for gateway compatibility and it changes nothing here. There is no personal data on this source: the only seller is momox SE, a company, and it is always returned in full. |
/medimops/v1/detail3 creditsEverything one medimops.de product page publishes, by momox article id, ISBN or EAN: the condition ladder (EUR price, unit stock count, discount versus new and sale flag per grade), the bibliographic record (EAN, ISBN-10 and ISBN-13, author, translator, publisher, binding, page count, publication date, language, weight, FSK rating), the description, the review score and star breakdown, the category breadcrumb and the price quoted for a new copy. `best_price` is the price of the best condition in stock, not the cheapest copy, so `lowest_price` and its grade come next to it. An id or barcode medimops does not carry is NOT_FOUND.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_id | optional | — | The momox article id, exactly as it appears at the end of every product url and in every `search` row (`M03551551677`). It is `M0` + the item's Amazon ASIN, and for a book that ASIN is the ISBN-10 — which is why `isbn` below is answered in a single request. Give this, or `isbn`, or `ean`. An id the store does not carry is NOT_FOUND. |
| isbn | optional | — | Look a BOOK up by its barcode. ISBN-13 and ISBN-10 are both accepted, with or without hyphens and spaces, and the check digit is verified before anything is requested. An ISBN-13 that starts with 978 is turned into the momox article id directly, so the lookup costs ONE request; `meta.resolved_by` says which route was used. (The source's own search answers a bare ISBN-10 with zero hits, so handing it one is not an option — this engine converts it.) |
| ean | optional | — | Look a CD, DVD, Blu-ray, game or piece of software up by its barcode. The full 13-digit EAN is required including leading zeros — the source answers `711719833857` with nothing and `0711719833857` with the right product, which is a 12-vs-13-digit trap worth knowing. A 12-digit UPC is padded to 13 here. Unlike a book ISBN, a non-book EAN is not inside the article id, so this route costs two requests (the source's own exact-match search, then the product page) and `meta.resolved_by` says so. |
| include_related = false | optional | — | Also return the other titles the source links to the same contributor on that page (up to a dozen rows with their own price, stock and url). Off by default because it roughly doubles the response for callers who only want the one product; it costs no extra request either way. |
| include_pii = false | optional | — | Accepted for gateway compatibility and it changes nothing here. There is no personal data on this source: the only seller is momox SE, a company, and it is always returned in full. |
/medimops/v1/categories1 creditThe medimops.de category tree, from its own category sitemap: every shelf with the numeric id that `search` takes as `category`, its name, depth, parent and url (300 shelves, 5 at the top). `top_level[].listing_count` is the shelf size momox measured on 2026-10-08, a fixed figure, not read live; a `search` response's `facets.category` carries live counts.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| max_depth = 9 | optional | 1–9 | How deep into the category tree to return. 1 = the five top-level shelves only, 2 = those plus their children, 9 = everything the source publishes (the deepest DE shelf measured sits 6 levels down). Depth is derived from the shelf's own url path, which is how the source itself nests them. |
| include_pii = false | optional | — | Accepted for gateway compatibility and it changes nothing here. There is no personal data on this source: the only seller is momox SE, a company, and it is always returned in full. |
curl -X POST https://api.reefapi.com/medimops/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"harry potter","condition":["UsedGood"],"sort":"price_desc"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.