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:

{
  "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:

{
  "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

{
  "productUrls": [
    {
      "url": "https://www.ikea.com/us/en/p/billy-bookcase-white-00263850/"
    }
  ]
}

Multiple Products

{
  "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

{
  "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!