JYSK APIjysk.pl ↗
Access JYSK Poland product catalog via API. Search products, browse categories, fetch deal prices, product details, and real-time store stock availability.
What is the JYSK API?
The JYSK Poland API covers 6 endpoints for querying the jysk.pl product catalog, including search, category browsing, deal listings, and per-store stock availability. The get_product_details endpoint returns over 10 fields per product — SKU, brand, variants, images, category, and pricing in PLN. Use get_store_availability to check online stock quantities and upcoming delivery dates by product ID.
curl -X GET 'https://api.parse.bot/scraper/067c4c6b-d287-4464-a6f2-f844201b6e73/search_products?page=1&query=biurko' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on JYSK Poland by keyword. Returns paginated results with product name, price, discount info, and availability. Each page returns up to 36 products.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based). |
| queryrequired | string | Search query term (e.g. 'biurko', 'materac', 'sofa'). |
{
"type": "object",
"fields": {
"count": "Number of products on this page",
"query": "The search query used",
"products": "Array of product objects with name, url, sku, price, original_price, discount_percentage, image, rating, online_available, store_available",
"total_count": "Total number of matching products",
"total_pages": "Total number of pages",
"current_page": "Current page number"
},
"sample": {
"data": {
"count": 36,
"query": "biurko",
"products": [
{
"sku": "3681949",
"url": "https://jysk.pl/biuro/biurka/biurko-billund-54x120-kolor-bialy-szary",
"name": "Biurko BILLUND 54x120 kolor biały/szary",
"image": "https://cdn3.jysk.com/getimage/wd3.medium/268317",
"price": "250 zł",
"rating": 4.7,
"original_price": "649 zł /szt.",
"store_available": true,
"online_available": true,
"discount_percentage": 61
}
],
"total_count": 48,
"total_pages": 2,
"current_page": 1
},
"status": "success"
}
}About the JYSK API
Product Search and Category Browsing
The search_products endpoint accepts a query string (e.g. 'materac', 'sofa', 'biurko') and an optional page parameter. Each response page returns up to 36 products with fields including name, sku, price, original_price, discount_percentage, rating, and online_available. The total_count and total_pages fields let you paginate through full result sets. For structured browsing by category, get_category_tree returns the complete navigation hierarchy as a recursive structure of objects with name, url, and children. Feed those url values into get_category_products along with an optional page parameter to retrieve paginated product listings from any category.
Product Details and Variants
get_product_details takes a product_url (path or full URL, obtained from search or category results) and returns a full product record: sku, brand, name, price, currency (PLN), category, images array, rating, and a variants array. Each variant object includes its own name, sku, color, price, and image, which is useful when a product is sold in multiple sizes or finishes.
Deals and Promotions
get_deals requires no parameters and returns all currently discounted products from active sale and campaign pages on jysk.pl. Each deal object includes discount_percentage, original_price, price, sku, and online_available. The total_deals field gives the full count of active promotions in a single call.
Store Stock and Delivery
get_store_availability accepts a product_id (SKU) and returns an online_stock object with quantity and a last-update timestamp, a next_delivery array with per-shipment source, quantity, and availability_date, and a store_availability object summarizing total_stores, stores_with_stock, and an in_stock_in_selected_store boolean. This makes it straightforward to surface in-store vs. online availability differences without a separate lookup.
The JYSK API is a managed, monitored endpoint for jysk.pl — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when jysk.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 jysk.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 price drops and discount_percentage changes across JYSK Poland's active promotions using get_deals
- Build a product comparison tool for JYSK furniture using variants returned by get_product_details
- Monitor online_stock quantity and next_delivery dates for high-demand products via get_store_availability
- Crawl the full category hierarchy with get_category_tree to index every product path on jysk.pl
- Aggregate rating values from search_products results to surface top-rated items in a specific category
- Alert users when a previously out-of-stock SKU shows quantity > 0 in the online_stock response
- Populate a price-comparison feed with sku, price, original_price, and discount_percentage from search or category results
| 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.