x-kom.pl APIx-kom.pl ↗
Access x-kom.pl product data via API: search, category browsing, product details, reviews, Q&A, promotions, flash deals, and store locations.
curl -X GET 'https://api.parse.bot/scraper/fe6e6b4a-c5c7-4687-86dd-fdc23768d1e3/search_products?page=1&limit=30&query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword with pagination and sorting. Returns paginated product listings matching the search query.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| sort | string | Sort order for results |
| limit | integer | Results per page |
| queryrequired | string | Search keyword (e.g. 'laptop', 'mysz gamingowa') |
{
"type": "object",
"fields": {
"Items": "array of product objects with Id, Name, Price, Producer, Category, MainPhoto, and other details",
"Groups": "array of product group/category facets with Id, Name, ProductCount",
"TotalCount": "integer total number of matching products",
"TotalPages": "integer total number of pages"
},
"sample": {
"data": {
"Items": [
{
"Id": "1370407",
"Name": "MacBook Pro M5/16GB/512/Mac OS Srebrny 10R GPU",
"Price": 7499,
"OldPrice": 7999,
"Producer": {
"Id": "357",
"Name": "Apple"
},
"MainPhoto": {
"Url": "https://cdn.x-kom.pl/i/setup/images/prod/big/product-large,,2025/10/pr_2025_10_16_10_25_57_444_00.jpg"
}
}
],
"Groups": [
{
"Id": "2",
"Name": "Laptopy i komputery",
"ProductCount": 8353
}
],
"TotalCount": 8452,
"TotalPages": 282
},
"status": "success"
}
}About the x-kom.pl API
The x-kom.pl API exposes 9 endpoints covering the full product catalog of one of Poland's largest electronics retailers. You can retrieve structured product data — including prices in PLN, specifications, photos, and availability — via endpoints like get_product_details, search_products, and get_hot_shot. Customer reviews with star ratings, Q&A threads, active promotions, and physical store locations with geo-coordinates are all accessible without any account or authentication on your end.
Product Search and Category Browsing
The search_products endpoint accepts a query string (e.g. 'laptop' or 'mysz gamingowa') and returns paginated results with TotalCount, TotalPages, and an Items array. Each item includes Id, Name, Price, Producer, Category, and MainPhoto. Results can be sorted and paginated with sort, page, and limit parameters. The get_category_products endpoint works similarly but filters by group_id (e.g. '4' for smartphones) or category_id (e.g. '159' for laptops), and both endpoints return Groups facets that show product counts per sub-category.
Product Details, Reviews, and Q&A
get_product_details returns the full product record for a given product_id, including a Photos array with Url and ThumbnailUrl fields, a Features array of specification objects, an HTML ProductDescription, and the current Price in PLN. If the product ID does not exist, the endpoint returns a stale_input signal with kind input_not_found. get_product_reviews returns paginated review Items with AuthorName, Body, Rating, RatingFivePoints, and CreateTime, plus a Statistics object covering rating distributions. get_product_questions returns customer Q&A threads with each question's Body, Author, Answers, and a Statistics block counting questions with and without answers.
Promotions and Flash Deals
get_hot_shot returns the currently active "Gorący strzał" daily flash deal, including OldPrice, the discounted Price, PromotionEnd as an ISO datetime, and a full nested Product object. get_promotions returns a paginated list of all products currently in promotion, structured identically to the category endpoint response. Both endpoints are useful for price-tracking and deal-alert applications.
Categories and Physical Stores
get_categories returns the full category tree: an array of groups, each containing a Categories array with Id, NameSingular, NamePlural, and ProductsCount. This is useful for mapping x-kom's taxonomy before issuing category-level queries. get_stores returns each physical salon with Name, Email, a structured Address object (Lines, City, PostCode, Country), OpenHours strings, and a GeoLocation object with Latitude and Longitude.
- Track flash deal prices over time using
get_hot_shotfieldsPrice,OldPrice, andPromotionEnd - Build a price comparison tool by querying
search_productsorget_product_detailsfor PLN prices across product categories - Aggregate and analyze customer sentiment from
get_product_reviewsusingRating,RatingFivePoints, andStatisticsdistributions - Populate a category navigator by pulling the full taxonomy tree from
get_categoriesincluding per-categoryProductsCount - Monitor active promotions inventory by paginating through
get_promotionsand recording product IDs and prices - Build a store locator by combining
get_storesGeoLocationcoordinates withAddressandOpenHoursdata - Answer pre-purchase questions programmatically by surfacing
get_product_questionsanswers alongside product specs
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does x-kom.pl have an official public developer API?+
What does `get_product_details` return when a product ID doesn't exist?+
product_id does not correspond to an active product, the endpoint returns a stale_input response with kind set to input_not_found rather than throwing an HTTP error. Your integration should check for this field before processing the response body.Does the API cover product stock levels or warehouse availability?+
get_product_details endpoint includes availability data within the product record, but real-time stock quantities per warehouse or per SKU variant are not broken out as discrete response fields. You can fork this API on Parse and revise it to add an endpoint that targets more granular inventory data if your use case requires it.Is historical pricing data accessible through this API?+
Price in product listings, OldPrice and Price in get_hot_shot, and current promotional prices in get_promotions. You can fork this API on Parse and revise it to store snapshots and build a price history layer on top.How does pagination work across endpoints that return product lists?+
search_products, get_category_products, get_product_reviews, and get_product_questions all accept page and limit parameters and return TotalCount and TotalPages in the response. You can iterate from page 1 up to TotalPages to retrieve a full result set. Default page size varies by endpoint when limit is not specified.