🔌 refurbed-scraper

A REST API for refurbed, the refurbished-electronics marketplace, covering all 24 country storefronts 🌍

This Actor runs in Standby mode:

• 🟢 always-on live server, no waiting for a run to finish
• ⚡ call an endpoint, get your answer back in the same request
• 🚫 no input schema or run config, every request is just a plain HTTP call with query params

🚀 Quick start

This Actor's Standby URL is:

https://hennobit--refurbed-scraper.apify.actor

(shown on this Actor's page under "This Actor uses Standby mode"). Call it directly:

$curl "https://hennobit--refurbed-scraper.apify.actor/search?query=macbook&country=de&token=<APIFY_TOKEN>"

Every response is JSON:

• ✅ { "ok": true, ... } on success
• ❌ { "ok": false, "error": { "status", "message" } } on failure

🧭 Recommended workflow

1. 🌍 GET /countries → which of the 24 country codes to use
2. 🗂️ GET /categories?country=de → find the category ID (a real tree via parentId)
3. 🎛️ GET /category/filters?category=11&country=de → see which attributes that category can be filtered on right now (RAM, colour, processor, ...) and their current valid values
4. 🔎 GET /category?category=11&country=de&minRamSize=16&processor=Apple+M2 → query using those filters, by name

No need to ever open refurbed.com in a browser to build a query. 🎉

📚 Endpoints

Endpoint	What it does	Billing
📄 GET /product?url=	Full detail for one product page (specs, description, seller, warranty, other configurations)	1 result
📄📄 GET /products?urls=	Same, for up to 20 URLs at once, fetched in parallel	1 result per successful item
🔎 GET /search?query=	Full-text search	1 result per product returned
🗂️ GET /category?category=	List products in a category, filterable by that category's own attributes	1 result per product returned
🌳 GET /categories?country=	Every category that country carries, as a tree (id, name, parentId)	1 lookup
🎛️ GET /category/filters?category=&country=	Live filter attributes for a category (name, type, current min/max or values)	1 lookup
🌍 GET /countries	The 24 supported country codes, names, domains, currencies	1 lookup

📖 Full parameter reference, request/response shapes and examples: see the API tab in the Apify Console for this Actor (interactive docs, generated straight from its schema).

📄 /product and /products

curl "https://hennobit--refurbed-scraper.apify.actor/product?url=https://www.refurbed.de/p/apple-macbook-air-m1-2020/&token=<APIFY_TOKEN>"
curl "https://hennobit--refurbed-scraper.apify.actor/products?urls=https://www.refurbed.de/p/a/,https://www.refurbed.de/p/b/&token=<APIFY_TOKEN>"

• specs and otherOptions keys are normalized to camelCase English (ramSize, processor, colour, ...) regardless of country, so you get the same keys no matter which of the 24 sites you're querying 🌐
• the values behind those keys stay in the site's own local language, same as everywhere else in this API

🔎 /search and 🗂️ /category

Both accept:

• country, minPrice, maxPrice
• sortPrice (relevance | asc | desc)
• maxResults (1–200, default 20)
• showOtherOptions
• rawFilters (advanced/manual escape hatch)

/category also accepts that category's own filter attributes by name (discovered via /category/filters) instead of hand-built rawFilters strings:

$curl "https://hennobit--refurbed-scraper.apify.actor/category?category=11&country=de&minRamSize=16&maxRamSize=64&processor=Apple+M2&token=<APIFY_TOKEN>"

• 🔢 numeric attribute → min<Name> / max<Name>
• 🏷️ enum attribute → bare name plus one of its current values

📖 Pagination: results are capped per call, but the response carries nextPage and hasMore so you can keep going:

curl "https://hennobit--refurbed-scraper.apify.actor/search?query=iphone&maxResults=50&token=<APIFY_TOKEN>"               # -> nextPage: 4
curl "https://hennobit--refurbed-scraper.apify.actor/search?query=iphone&maxResults=50&page=4&token=<APIFY_TOKEN>"         # continues from there

⚠️ page is refurbed's own listing page, not a raw item offset. Always pass back the previous response's nextPage rather than incrementing it yourself.

💸 Pricing (Pay-Per-Event)

• result 💎: one per product actually returned, across /product, /products, /search, /category
• lookup 🔍: one per call to /categories, /category/filters, or /countries. These exist to help you build a cheap, precise result request, so they're priced far below it, though still metered.

Check the Actor's page in the Apify Store for current prices per event.

If your run's spending limit can't cover a full request:

• /search / /category / /products → return whatever was affordable, with chargeLimitReached: true, instead of failing
• /product and the lookup endpoints → 402 instead, since they're a single, indivisible unit

Either way, you're never billed for more than you actually get back. 🛡️

🕒 Data freshness

What	Freshness
Product/listing data (/product, /products, /search, /category)	🔴 always live
Filter attributes (/category/filters)	🔴 always live; min/max ranges and stock levels change within hours
Category tree (/categories)	🟡 refreshed periodically, not on every call (see generatedAt in the response)
/countries	🟡 maintained by hand, not scraped live; a new country storefront won't show up here until this list is updated

A brand-new or renamed category may take a little while to show up in /categories.