x-kom APIx-kom.pl ↗
Access x-kom.pl product search, category browsing, reviews, Q&A, flash deals, promotions, and store locations via a structured JSON API.
What is the x-kom API?
The x-kom.pl API exposes 10 endpoints covering the full product catalog of Poland's major electronics retailer. Use search_products for keyword-based catalog search returning pricing, producer, ratings, and availability, or get_product_details to pull technical specifications, photo arrays, and per-store availability for a single item. Endpoints also cover customer reviews, Q&A threads, ongoing promotions, the daily flash deal, and physical store locations.
curl -X GET 'https://api.parse.bot/scraper/fe6e6b4a-c5c7-4687-86dd-fdc23768d1e3/search_products?page=1&sort=AvailabilityStatus+desc%2CAccuracyB+desc&limit=10&query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Full-text search over x-kom.pl product catalog. Returns paginated product listings matching the query keyword. Each result includes pricing, producer, category, ratings, and availability. Paginates via integer page counter; server-side ordering via the sort param.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based) |
| sort | string | Sort order for results. |
| limit | integer | Results per page (max 30) |
| queryrequired | string | Search keyword (e.g. 'laptop', 'mysz gamingowa') |
{
"type": "object",
"fields": {
"Page": "integer current page number",
"Items": "array of product summary objects with Id, Name, Price, Producer, Category, MainPhoto, CommentsRating, CommentsCount, FeatureSummary, AvailabilityStatus, WebUrl",
"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": {
"Page": 1,
"Items": [
{
"Id": "1370452",
"Name": "MacBook Pro M5/32GB/1TB/Mac OS Srebrny 10R GPU",
"Price": 10999,
"WebUrl": "https://www.x-kom.pl/p/1370452-laptop-14-apple-macbook-pro-m5-32gb-1tb-mac-os-srebrny-10r-gpu.html",
"Category": {
"Id": "2980",
"NameSingular": "Laptop 14\""
},
"OldPrice": null,
"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"
},
"CommentsCount": 28,
"CommentsRating": 6,
"FeatureSummary": [
"Procesor: Apple M5",
"Pamięć: 32 GB"
],
"AvailabilityStatus": "Available"
}
],
"Groups": [
{
"Id": "2",
"Name": "Laptopy i komputery",
"ProductCount": 8992
}
],
"TotalCount": 9094,
"TotalPages": 304
},
"status": "success"
}
}About the x-kom API
Product Search and Category Browsing
The search_products endpoint accepts a required query parameter (e.g. 'laptop', 'mysz gamingowa') and returns paginated results with each item's Id, Name, Price, Producer, Category, MainPhoto, CommentsRating, CommentsCount, and FeatureSummary. Pagination is controlled via page (1-based integer) and limit (up to 30 per page); TotalCount and TotalPages allow you to walk the full result set. A Groups array provides category facets with product counts. The get_category_products endpoint works identically but filters by category_id or group_id — IDs you can discover from get_categories, which returns the complete nested group and category tree including NameSingular, NamePlural, and per-category product counts.
Product Detail, Reviews, and Q&A
get_product_details returns the deepest data shape in the API: a Features array of technical specification objects (each with FullName and ValueGroups), a Photos array with Url and ThumbnailUrl, an HTML ProductDescription, AvailabilityStatus, and a CommentStatistics object covering AverageRating and full rating distributions. If the product_id is not found the endpoint returns a stale_input signal with kind input_not_found.
get_product_reviews paginates customer reviews per product. Each review includes AuthorName, Body, dual-scale ratings (Rating on a 1–6 scale and RatingFivePoints on a 1–5 scale), CreateTime, Votes, and an IsConfirmedByPurchase flag. get_product_questions returns paginated Q&A threads with nested Answers, author info, timestamps, and vote counts, plus aggregate Statistics on answered vs. unanswered question counts.
Deals, Promotions, and Store Data
get_hot_shot requires no parameters and returns the active daily flash deal: Price, OldPrice, PromotionEnd (ISO datetime), IsActive, PromotionGainText, and the full nested Product object. get_promotions and get_deals both paginate promotional listings; get_deals merges clearance and promotional items and adds computed DiscountAmount and DiscountPercentage fields derived from price delta fields. get_stores returns the full list of x-kom retail salons with Address (lines, city, postcode), OpenHours, Email, and GeoLocation (latitude and longitude).
The x-kom API is a managed, monitored endpoint for x-kom.pl — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when x-kom.pl changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official x-kom.pl API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track daily flash deal prices via get_hot_shot to alert users when specific product categories go on sale
- Build a price comparison tool using search_products and get_product_details Price fields across multiple queries
- Aggregate customer sentiment by collecting get_product_reviews Body, Rating, and IsConfirmedByPurchase across a category
- Populate a product catalog with structured specs by looping get_category_products then get_product_details Features arrays
- Map x-kom physical store locations using get_stores GeoLocation coordinates for a store-finder feature
- Monitor promotional inventory by paginating get_deals and tracking DiscountPercentage changes over time
- Answer pre-purchase questions programmatically by surfacing get_product_questions Items with nested Answers
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.