x-kom API

Search x-kom, al.to and neonet, then read every price a product has: shelf, promo code and Omnibus 30-day

x-kom is one of Poland's large electronics retailers (laptops, smartphones, PC parts, monitors, gaming), with al.to and neonet.pl running on the same shop platform.

no credit card1,000 free credits · instant API key · pay by card or crypto
Missing a x-kom endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
X
/x-kom/v1

6 active endpoints, on 1 and 2 credit tiers.

  • POST/x-kom/v1/search
  • POST/x-kom/v1/category
  • POST/x-kom/v1/product
  • POST/x-kom/v1/reviews
  • POST/x-kom/v1/hot_shot
  • POST/x-kom/v1/categories

What x-kom endpoints does ReefAPI ship?

6 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

6 endpoints

search

2 cr

Search x-kom.pl (or al.to / neonet.pl) by keyword with the shop's own category, brand, price…

required
query
optional
category_id, brand_id, price_min, price_max, only_available, sort, page, limit, site

category

2 cr

List one x-kom category (e.g.

required
category_id
optional
brand_id, price_min, price_max, only_available, sort, page, limit, site

product

2 cr

The full product record by id or URL.

required
—
optional
product_id, url, site

reviews

1 cr

Customer reviews of a product.

required
product_id
optional
sort, rating, this_variant_only, confirmed_only, page, limit, site

hot_shot

2 cr

The shop's current 'Gorący strzał' (hot shot) deal.

required
—
optional
site

categories

1 cr

The shop's category tree.

required
—
optional
group_id, site

Every parameter, every allowed value →

x-kom API

4 of 6 endpoints, ready to run

View docs ↗

iPhone 17 on x-kom

2 credits1 required · 1 optional
POST/x-kom/v1/search
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

How the x-kom API works

x-kom is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 530 engines.

02
Call
POST /x-kom/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
1 or 2 credits per call

Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

From a keyword to a daily x-kom price feed

Search once to find products and their categories, list a category with filters, then follow each product and its reviews.

01search?query=iphone
GET/x-kom/v1/search?query=iphone
17

30 products per page with shelf, promo-code and Omnibus prices, availability, rating and category, plus brand and category counts.

02category?category_id=<category.id>&brand_id=<brand_id>&sort=price_asc
GET/x-kom/v1/category?category_id=<category.id>&brand_id=<brand_id>&sort=price_asc

One category and brand, cheapest first; page with page=2, 3 … while has_more is true.

03product?product_id=<product_id>
GET/x-kom/v1/product?product_id=<product_id>

Every price fact with the code and its dates, pickup per store, shipping options, specifications, variants and images.

04reviews?product_id=<product_id>&this_variant_only=true
GET/x-kom/v1/reviews?product_id=<product_id>&this_variant_only=true

Written reviews of exactly that product.

A dated x-kom price feed per product with the shelf price, the promo-code price and its end date, and the Omnibus 30-day price kept apart.

request
curl -X POST https://api.reefapi.com/x-kom/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"iphone 17","limit":10}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "x-kom",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}

What an x-kom field actually contains

Fields that read differently from how they look. Every row was measured against live x-kom responses on 2026-10-15.

FieldWhat it holds
priceThe shelf price in PLN, VAT included, before any promo code. Search and product agreed on 12 of 12 products.
code_price, promo_codeThe lower price x-kom gives with a promo code at checkout (for example 'rabat12'), with the code, its start and end time (Polish local time), the per-customer limit and whether it is running now. The product page's structured data shows this code price, not the shelf price, while a code runs.
filter_priceThe price the price_min / price_max range and the price sorts use: the promo-code price when a code is published, otherwise the shelf price. A laptop shelf-priced 3,499 zł with a 2,599 zł code is inside 2,000-3,000 zł.
lowest_price_30dThe lowest price of the last 30 days that EU Omnibus rules require next to a promotion. It equalled the figure printed on the product page on 6 of 6 discounted products.
rating, rating_5rating is x-kom's own 1-6 score; rating_5 is the same opinion on a five-star scale, the figure x-kom's product page structured data publishes.
stores[]Pickup availability in each x-kom store: a status code (available, available_soon, temporary_unavailable), the text and the earliest pickup date. x-kom does not publish a unit count per store.
review_count, reviewsx-kom pools reviews across all variants of a model (colours, memory sizes). Each review names the product id it was written on; this_variant_only keeps only the product you asked about (310 reviews → 105 on one model).
hot_shot.quantity_total, quantity_soldHow many units the deal has and how many are already sold, as x-kom reports them while the deal runs.

On 8 products the product page's own structured data matched: brand 8 of 8, review count 4 of 4 reviewed products, star rating 4 of 4, and its price equalled our code_price on all 6 products with a running code and our price on the 2 without one. Prices, promo codes, shipping options and store availability were identical from four different networks.

x-kom coverage, measured

Every number below was read from live x-kom responses on 2026-10-15.

Catalogue

x-kom.pl, al.to and neonet.pl (Poland, PLN). Laptops 3,848 products, smartphones 900; 'iphone 17' 2,714 matches, 'rtx 5070' 1,074, 'pendrive' 326.

Filters that bite

Laptops 3,848 → Apple 814, in stock 3,431, 2,000-3,000 zł 65; 'iphone 17' 2,714 → smartphones 55. Price sorts in order on 60 of 60 rows.

Price accuracy

Search and product agreed on 12 of 12 products (price and promo-code price). The product page's own data matched our promo-code price on 6 of 6 discounted products and our price on 2 of 2 others; the Omnibus 30-day price matched the printed figure on 6 of 6.

Fields

On 313 products from 10 searches and 5 categories: id, name, brand, URL, category, price and availability 313 of 313; image 310; key specs 311; producer code 294; rating 227; instalment offer 224; Omnibus 30-day price 25; crossed-out price 19; promo-code price 6.

Limits

No EAN in x-kom's data; no unit count per store; reviews are pooled across a model's variants unless this_variant_only is set; pages are 1-60 products.

What people build with x-kom

The jobs this data is most often used for.

6

endpoints

1/2

credits per call

01

Track x-kom shelf prices, promo-code prices and Omnibus 30-day prices on electronics day by day.

02

Watch the daily x-kom hot shot: price, saving, units sold and when it ends.

03

Compare x-kom, al.to and neonet.pl prices for the same product.

04

Collect customer reviews per model or per exact variant, with confirmed-purchase flags.

What x-kom data costs

The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 530 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/x-kom/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"iphone 17","limit":10}'
python
import requests

r = requests.post(
    "https://api.reefapi.com/x-kom/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "iphone 17",
  "limit": 10
},
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up x-kom.

Get a free key →
Do I need an x-kom account?▾

No. Everything is read logged out, and you call reefapi.com from anywhere.

Which price is the real one?▾

Both: price is what the product costs without a code; code_price is what it costs with the promo code shown in promo_code, while the code runs. lowest_price_30d is the reference price required by law during a promotion, old_price the crossed-out price when x-kom shows one.

Do the filters work?▾

Yes, each was checked against the unfiltered count in the same run. Laptops: 3,848 products; Apple 814; in stock 3,431; 2,000-3,000 zł 65. 'iphone 17' 2,714 matches, in the smartphone category 55. Price sorts follow filter_price with no order breaks on 60 rows.

Can I read al.to and neonet.pl too?▾

Yes, set site to alto or neonet. They run on the same platform and return the same fields. al.to shares product ids with x-kom.pl. neonet sometimes has no hot shot running; the API then says so.

How deep can I page?▾

Up to the last page the shop reports in pages. Three consecutive pages of smartphones shared no product. The page right after the last returns no rows with page_past_end set; asked for 60 rows the shop sometimes sends 59.

Is the EAN included?▾

No. x-kom's catalogue data carries no EAN; products are identified by x-kom's product id and the manufacturer code (producer_code).

When does the hot shot change?▾

Each deal carries its own starts_at and ends_at. On 2026-10-15 x-kom's deal ran 10:00-22:00 and al.to's 09:00 to 09:00 the next day, each for a different product.

What is the x-kom API?▾

x-kom API is a ReefAPI endpoint group for polish electronics retailer x-kom.pl (plus al.to and neonet.pl): pln shelf, promo-code and omnibus 30-day prices, store pickup, specs, reviews and the daily hot shot. It returns live JSON through POST requests under /x-kom/v1.

Is the x-kom API free to try?▾

Yes. ReefAPI starts with 1,000 free credits, no card required. x-kom calls use the same shared credit balance as every other ReefAPI engine.

Do I need a x-kom login or account?▾

No login to x-kom 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 x-kom 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 x-kom API use?▾

x-kom actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call x-kom from an AI assistant or MCP client?▾

Yes. Connect ReefAPI once through MCP and your assistant can call x-kom actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the x-kom API a x-kom scraper?▾

It is the managed alternative to a DIY x-kom 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 polish electronics retailer x-kom.pl (plus al.to and neonet.pl): pln shelf, promo-code and omnibus 30-day prices, store pickup, specs, reviews and the daily hot shot back as clean JSON.

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 529 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-10-15.