CeX API & Scraper
CeX API returns live CeX data as clean JSON for cex The primary endpoint, search, returns matching records including box id, title, price sell, price cash and price exchange.
🤖 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.
Developers reach for it when they need to track product listings, prices, availability, variants and reviews without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a CeX scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, product, store_stock, stores. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/cex/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "ps5",
"country": "uk"
}
}{
"ok": true,
"meta": {
"api": "cex",
"endpoint": "search",
"mode": "live",
"latency_ms": 1229.4,
"record_count": 24,
"bytes": 262127,
"cache_hit": false,
"pagination": {
"page": 1,
"page_size": 24,
"total": 2091,
"has_more": true
},
"country": "uk",
"currency": "GBP",
"charged_credits": 1,
"version": "0.1.0",
"request_id": "3f6072fc707f4b43",
"queue_ms": 1,
"fetched_at": "2026-11-03T17:32:02.118Z"
},
"data": {
"results": [
{
"box_id": "SPS5D825GBW003",
"title": "Playstation 5 Digital Edition Console, 825GB, White, Discounted",
"url": "https://uk.webuy.com/product-detail?id=SPS5D825GBW003",
"currency": "GBP",
"category": "Playstation5 Consoles",
"category_id": 1143,
"product_lines": [
"Gaming Consoles",
"PlayStation 5"
],
"supercategory": "Gaming",
"brand": null,
"condition": "Discounted",
"grade": null,
"rating": null,
"image": "https://uk.static.webuy.com/product_images/Gaming/Playstation5 Consoles/SPS5D825GBW003_l.jpg",
"images": {
"small": "https://uk.static.webuy.com/product_images/Gaming/Playstation5 Consoles/SPS5D825GBW003_s.jpg",
"medium": "https://uk.static.webuy.com/product_images/Gaming/Playstation5 Consoles/SPS5D825GBW003_m.jpg",
"large": "https://uk.static.webuy.com/product_images/Gaming/Playstation5 Consoles/SPS5D825GBW003_l.jpg"
},
"in_stock_online": true,
"stock_online": 30,
"in_stock_in_store": true,
"store_count": 275,
"stores": [
"London - W1 Tottenham Crt Rd",
"London - W1 Rathbone Place",
"Birmingham"
],
"collection_stores": [
"Aberdeen",
"Accrington",
"Acocks Green"
],
"collection_quantity": 30,
"availability": [
"In Stock In Store",
"In Stock Online"
],
"out_of_stock_stores": [
"WeBuy Central",
"RMA CENTRE",
"Hounslow"
],
"out_of_stock_store_count": 145,
"is_new_item": false,
"discontinued": false,
"price_last_changed": "2026-09-23T02:00:03",
"master_box_id": "0",
"attributes": {
"Item": "Sony Playstation 5",
"Edition": "Digital Edition",
"Storage": "825GB",
"Meta Title": "Second Hand PlayStation 5 - Great Value at CeX",
"Model Name": "Playstation 5",
"Main Colour": "White",
"Meta Keywords": "second hand playstation 5",
"Console Colour": "White",
"Meta Description": "Get a second hand PlayStation 5 at an unbeatable price. Reliable, tested, and ready for next-gen gaming. Shop at CeX today.",
"Number of Controllers": "1",
"superCatActive": "1",
"categoryReadOnly": "0",
"superCatShowOnWWW": "1",
"showOnWebHotProducts": "1",
"superCatDisplayOrder": "1"
},
"country": "uk",
"price_sell": 455,
"price_cash": 291,
"price_exchange": 336,
"previous_price_sell": 435,
"first_price_sell": 340,
"price_reduced": false,
"cash_percent_of_sell": 64,
"exchange_percent_of_sell": 74,
"sells_this_item": true,
"buys_this_item": true
},
{
"box_id": "SPS5825GBW003",
"title": "Playstation 5 Console, 825GB, White, Discounted",
"url": "https://uk.webuy.com/product-detail?id=SPS5825GBW003",
"currency": "GBP",
"category": "Playstation5 Consoles",
"category_id": 1143,
"product_lines": [
"Gaming Consoles",
"PlayStation 5"
],
"supercategory": "Gaming",
"brand": null,
"condition": "Discounted",
"grade": null,
"rating": null,
"image": "https://uk.static.webuy.com/product_images/Gaming/Playstation5 Consoles/SPS5825GBW003_l.jpg",
"images": {
"small": "https://uk.static.webuy.com/product_images/Gaming/Playstation5 Consoles/SPS5825GBW003_s.jpg",
"medium": "https://uk.static.webuy.com/product_images/Gaming/Playstation5 Consoles/SPS5825GBW003_m.jpg",
"large": "https://uk.static.webuy.com/product_images/Gaming/Playstation5 Consoles/SPS5825GBW003_l.jpg"
},
"in_stock_online": true,
"stock_online": 30,
"in_stock_in_store": true,
"store_count": 379,
"stores": [
"London - W1 Tottenham Crt Rd",
"London - W1 Rathbone Place",
"Birmingham"
],
"collection_stores": [
"Aberdeen",
"Accrington",
"Acocks Green"
],
"collection_quantity": 30,
"availability": [
"In Stock In Store",
"In Stock Online"
],
"out_of_stock_stores": [
"East Grinstead",
"Logistics",
"Runcorn"
],
"out_of_stock_store_count": 41,
"is_new_item": false,
"discontinued": false,
"price_last_changed": "2026-10-27T03:00:20",
"master_box_id": "0",
"attributes": {
"Item": "Sony Playstation 5",
"Edition": "Standard Edition",
"Storage": "825GB",
"Meta Title": "Used PlayStation 5 - Buy PS5 Console at CeX",
"Model Name": "Playstation 5",
"Main Colour": "White",
"Meta Keywords": "used playstation 5",
"Console Colour": "White",
"Meta Description": "Shop used PlayStation 5 consoles at CeX. Fully tested for performance and backed by warranty. Secure your PS5 today.",
"Number of Controllers": "1",
"superCatActive": "1",
"categoryReadOnly": "0",
"superCatShowOnWWW": "1",
"showOnWebHotProducts": "1",
"superCatDisplayOrder": "1"
},
"country": "uk",
"price_sell": 470,
"price_cash": 300,
"price_exchange": 347,
"previous_price_sell": 460,
"first_price_sell": 805,
"price_reduced": false,
"cash_percent_of_sell": 64,
"exchange_percent_of_sell": 74,
"sells_this_item": true,
"buys_this_item": true
},
{
"box_id": "SPS5825GBW001",
"title": "Playstation 5 Console, 825GB, White, Boxed",
"url": "https://uk.webuy.com/product-detail?id=SPS5825GBW001",
"currency": "GBP",
"category": "Playstation5 Consoles",
"category_id": 1143,
"product_lines": [
"Gaming Consoles",
"PlayStation 5"
],
"supercategory": "Gaming",
"brand": null,
"condition": "Boxed",
"grade": null,
"rating": null,
"image": "https://uk.static.webuy.com/product_images/Gaming/Playstation5 Consoles/SPS5825GBW001_l.jpg",
"images": {
"small": "https://uk.static.webuy.com/product_images/Gaming/Playstation5 Consoles/SPS5825GBW001_s.jpg",
"medium": "https://uk.static.webuy.com/product_images/Gaming/Playstation5 Consoles/SPS5825GBW001_m.jpg",
"large": "https://uk.static.webuy.com/product_images/Gaming/Playstation5 Consoles/SPS5825GBW001_l.jpg"
},
"in_stock_online": true,
"stock_online": 30,
"in_stock_in_store": true,
"store_count": 306,
"stores": [
"Edinburgh Cameron Toll",
"St Austell",
"Windsor"
],
"collection_stores": [
"Aberdeen",
"Accrington",
"Acocks Green"
],
"collection_quantity": 30,
"availability": [
"In Stock In Store",
"In Stock Online"
],
"out_of_stock_stores": [
"London - W1 Rathbone Place",
"WeBuy Central",
"RMA CENTRE"
],
"out_of_stock_store_count": 114,
"is_new_item": false,
"discontinued": false,
"price_last_changed": "2026-09-08T02:00:05",
"master_box_id": "0",
"attributes": {
"Item": "Sony Playstation 5",
"Edition": "Standard Edition",
"Storage": "825GB",
"Meta Title": "PlayStation 5 for Sale at CeX - Buy PS5 Today",
"Model Name": "Playstation 5",
"Main Colour": "White",
"Meta Keywords": "playstation 5 for sale",
"Console Colour": "White",
"Meta Description": "Grab a pre owned PlayStation 5 for sale at CeX. Fully tested and certified for quality. Shop the PS5 online now and enjoy immersive gaming.",
"Number of Controllers": "1",
"superCatActive": "1",
"categoryReadOnly": "0",
"superCatShowOnWWW": "1",
"showOnWebHotProducts": "1",
"superCatDisplayOrder": "1"
},
"country": "uk",
"price_sell": 500,
"price_cash": 320,
"price_exchange": 370,
"previous_price_sell": 480,
"first_price_sell": 625,
"price_reduced": false,
"cash_percent_of_sell": 64,
"exchange_percent_of_sell": 74,
"sells_this_item": true,
"buys_this_item": true
}
],
"count": 24,
"total": 2091,
"total_unfiltered": null,
"page": 1,
"page_size": 24,
"has_more": true,
"pagination_cap": 1000,
"facets": {
"category": [
{
"value": "Playstation5 Games",
"count": 1704
},
{
"value": "Playstation5 Controllers",
"count": 160
},
{
"value": "Playstation5 Accessories",
"count": 146
}
],
"product_line": [
{
"value": "PlayStation 5",
"count": 2091
},
{
"value": "Gaming Software",
"count": 1704
},
{
"value": "Gaming Accessories",
"count": 306
}
],
"supercategory": [
{
"value": "Gaming",
"count": 2091
}
],
"brand": [
{
"value": "Sony",
"count": 181
},
{
"value": "Razer",
"count": 21
},
{
"value": "scuf",
"count": 14
}
],
"condition": [
{
"value": "Discounted",
"count": 55
},
{
"value": "Boxed",
"count": 12
},
{
"value": "Unboxed",
"count": 12
}
],
"grade": [
{
"value": "A",
"count": 41
},
{
"value": "B",
"count": 40
},
{
"value": "C",
"count": 40
}
]
},
"filters_applied": {},
"sort": "relevance",
"currency": "GBP",
"country": "uk",
"query": "ps5"
}
}What the CeX API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search the CeX catalogue of one country. Every row carries the three prices side by side — the selling price, the cash price CeX pays you and the trade-in voucher price — plus the grade, the condition, online stock, the list of shops that hold the item and live facet counts. Filter by category, department, product line, brand, condition, grade, shop, stock and price; sort by price, name, rating or popularity. Give at least `query`, `category`, `supercategory`, `product_line`, `brand` or `store`. | Pricing teams call search to search the CeX catalogue of one country. | query, country, category, supercategory, product_line, ... |
| product | One CeX product in full: the three prices (selling, cash and voucher) with the previous and launch selling price and when the price last changed, whether CeX currently sells and buys it, the grade and condition, the full description, every image, online and collection stock, the variant group and all of the product's own attributes. | Marketplace operators call product to get one CeX product in full. | box_id, country |
| store_stock | Live per-shop stock for one product across the whole CeX store network: every shop that holds it, how many units are on hand, the quantity reserved for click-and-collect and whether collection is available there. This is the chain's physical inventory, not an online availability flag. | Catalog enrichment teams call store_stock to get live per-shop stock for one product across the whole CeX store network. | box_id, country |
| stores | The CeX shop network of one country: every shop with its id, name, region, phone number, coordinates and today's closing time. With `store_id`, one shop with its full weekly opening and break hours instead. | Retail analysts call stores to get the CeX shop network of one country. | country, store_id |
| taxonomy | The CeX browse tree of one country — the seven departments and their product lines — together with live category and product-line counts taken from the search index, so each name can be pasted straight into `search`. | Pricing teams call taxonomy to get the CeX browse tree of one country. | country, supercategory_id |
Call search from your stack
curl -X POST https://api.reefapi.com/cex/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"ps5","country":"uk"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/cex/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "ps5",
"country": "uk"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/cex/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "ps5",
"country": "uk"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.cex.search with {"query":"ps5","country":"uk"}.Who uses this API and why
- Pricing teams use CeX to search the CeX catalogue of one country.
- Marketplace operators use CeX to get one CeX product in full.
- Catalog enrichment teams use CeX to get live per-shop stock for one product across the whole CeX store network.
- Retail analysts use CeX to get the CeX shop network of one country.
- Pricing teams use CeX to get the CeX browse tree of one country.
Questions developers ask before integrating
What is the CeX API?
CeX API is a ReefAPI endpoint group for cex It returns live JSON through POST requests under /cex/v1.
Is the CeX API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. CeX calls use the same shared credit balance as every other ReefAPI engine.
Do I need a CeX login or account?
No login to CeX 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 CeX 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 CeX API use?
CeX actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call CeX from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call cex actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the CeX API a CeX scraper?
It is the managed alternative to a DIY CeX scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same cex back as clean JSON.
Why does my CeX scraper keep getting blocked?
Most CeX scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.