IKEA Product Availability Actor Documentation ## Overview The IKEA Product Availability Actor is a web scraping tool that helps you check the availability of IKEA products across different stores. Simply provide IKEA product URLs, and the actor will extract product information and return detailed availability data including stock levels, store locations, and restocking information. ## What This Actor Does - Extracts Product IDs: Automatically extracts product IDs from IKEA URLs - Checks Availability: Retrieves real-time stock information from IKEA's API - Store Information: Provides availability across different IKEA store locations - Restocking Data: Shows expected restock dates when items are out of stock - Bulk Processing: Handles multiple product URLs in a single run ## Input Configuration ### Required Input Format The actor expects an input object with the following structure: json { "productUrls": [ { "url": "https://www.ikea.com/us/en/p/billy-bookcase-white-00263850/" }, { "url": "https://www.ikea.com/us/en/p/malm-bed-frame-white-00263862/" } ] } ### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | productUrls | Array | Yes | Array of objects containing IKEA product URLs | | productUrls[].url | String | Yes | Valid IKEA product URL | ### Supported URL Formats The actor supports various IKEA URL formats: - https://www.ikea.com/us/en/p/product-name-12345678/ - https://www.ikea.com/gb/en/p/product-name-12345678/ - https://www.ikea.com/se/sv/p/product-name-art-12345678/ - URLs with query parameters: ?art=12345678 or ?artNumber=12345678 ## Output Data ### Response Structure For each product URL, the actor returns detailed availability information: json { "availabilities": [ { "itemKey": { "itemNo": "00263850", "itemType": "ART" }, "availableStock": 150, "restocks": [ { "type": "DELIVERY", "quantity": 50, "earliestDate": "2024-01-15", "latestDate": "2024-01-20" } ], "storesList": [ { "buCode": "367", "name": "IKEA Brooklyn", "availableStock": 25, "inStockProbabilityCode": "HIGH" } ], "salesLocations": { "salesLocation": [ { "locationCode": "15", "locationName": "Self-serve furniture warehouse" } ] } } ] } ### Key Output Fields | Field | Description | |-------|-------------| | itemKey.itemNo | Product article number | | itemKey.itemType | Product type (usually "ART") | | availableStock | Total available stock across all locations | | restocks | Array of expected restocking information | | storesList | Availability data for individual stores | | salesLocations | Physical locations where product can be found | | displayLocations | Showroom display locations | ### Stock Probability Codes - HIGH - Good availability (usually 10+ items) - MEDIUM - Limited availability (usually 1-9 items) - LOW - Very limited availability - OUT_OF_STOCK - Currently unavailable ## Usage Examples ### Basic Usage json { "productUrls": [ { "url": "https://www.ikea.com/us/en/p/billy-bookcase-white-00263850/" } ] } ### Multiple Products json { "productUrls": [ { "url": "https://www.ikea.com/us/en/p/billy-bookcase-white-00263850/" }, { "url": "https://www.ikea.com/us/en/p/hemnes-bed-frame-white-stain-00263860/" }, { "url": "https://www.ikea.com/gb/en/p/malm-chest-of-4-drawers-white-80263861/" } ] } ## Error Handling The actor includes comprehensive error handling: ### Common Errors 1. Invalid URL Format - Error: Product ID could not be extracted from URL - Solution: Ensure URL follows supported IKEA URL patterns 2. Product Not Found (404) - Error: Product with specified ID was not found - Solution: Verify the product URL is correct and product exists ### Error Response Format json { "error": "Product Description with this URL=> 12345678 was not found. Error Code: 404", "productUrl": "https://www.ikea.com/us/en/p/invalid-product-12345678/", "timestamp": "2024-01-01T12:00:00Z" } ## Technical Details ### Rate Limiting - The actor processes URLs sequentially to avoid overwhelming IKEA's servers - Built-in error handling for rate limiting scenarios - Recommended: Use reasonable delays between large batches ### Data Storage - Each product result is stored individually using Actor.pushData() - Final combined results are stored as output using Actor.setValue() - Data persists in Apify's dataset for further processing ## Best Practices ### Input Preparation 1. Validate URLs: Ensure all URLs are valid IKEA product pages 2. Remove Duplicates: Avoid processing the same product multiple times 3. Batch Processing: For large lists, consider breaking into smaller batches ### Performance Optimization 1. Sequential Processing: The actor processes URLs one by one to maintain stability 2. Error Recovery: Failed requests don't stop the entire batch 3. Data Persistence: Results are saved incrementally to prevent data loss ### Monitoring 1. Check Logs: Monitor console output for processing status 2. Verify Results: Check both individual pushData results and final output 3. Handle Errors: Review error messages for failed products ## Limitations 1. Regional Availability: Currently optimized for specific regions 2. Rate Limits: Subject to IKEA's API rate limiting 3. URL Formats: Only supports standard IKEA URL patterns 4. Real-time Data: Availability data reflects the time of the request ## Troubleshooting ### Common Issues Issue: No data returned for valid URLs - Solution: Check if the product ID extraction is working correctly - Debug: Enable logging to see extracted product IDs Issue: 404 errors for existing products - Solution: Verify the URL format matches supported patterns - Check: Ensure the product is available in the targeted region Issue: Incomplete availability data - Solution: Some products may have limited availability information - Note: This is normal for certain product types or regions ### Debug Mode To enable detailed logging, monitor the console output which includes: - URL processing status - Extracted product IDs - API response status - Error details The actor will continue to process valid URLs even if some fail, ensuring maximum data retrieval from your input list. ## Related Actor - Ikea Product Search - Ikea Product Description --- ## Support If you have any questions or encounter any issues, please consult the Apify documentation or reach out to us through one of the following channels: * Telegram: @pintoflow * Email: pintoflowpt@gmail.com * Apify Platform: You can also contact us directly through this platform. --- Ready to start scraping IKEA products? Configure your input and run the actor!