KICKS CREW Product Description Actor

Overview

The KICKS CREW Product Description Actor is a web scraping tool deployed on the Apify platform that extracts detailed product information from KicksCrew.com, a popular sneaker and streetwear retailer. This actor retrieves comprehensive product data including pricing, availability, variants, and specifications for sneakers and other products.

Features

• Multi-product processing: Extract data from multiple product URLs in a single run
• Regional pricing support: Get localized pricing and availability for different regions
• Comprehensive data extraction: Retrieve detailed product information including variants, images, and specifications
• Rate limiting: Built-in random delays to prevent overwhelming the target website
• Structured output: Returns well-formatted JSON data suitable for further processing

Input Configuration

Required Parameters

productUrls (Array of Objects)

• Type: Array
• Description: List of KicksCrew product URLs to scrape
• Format: Each item should be an object with a url property
• Example:

[
  { "url": "https://www.kickscrew.com/en-US/products/air-jordan-4-retro-white-cement-2025-fv5029-100" },
  { "url": "https://www.kickscrew.com/en-US/products/wmns-air-jordan-11-low-igloo-ah7860-103" }
]

Optional Parameters

countryIso (String)

• Type: String
• Description: Region code for localized pricing and availability
• Default: "US"
• Available Options:
  • US - United States
  • EU - Europe
  • UK - United Kingdom
  • CA - Canada
  • AU - Australia
  • JP - Japan
  • CN - China
  • HK - Hong Kong
  • SG - Singapore
  • KR - South Korea
  • MY - Malaysia
  • TH - Thailand
  • PH - Philippines

Output Data Structure

The actor returns detailed product information for each processed URL. Here's the structure of the output data:

Product Information

• id: Unique product identifier
• title: Product name and model
• description: Detailed product description
• availableForSale: Boolean indicating if the product is available
• productType: Category (e.g., "Sneakers")
• vendor: Brand name (e.g., "Air Jordan")
• handle: URL-friendly product identifier
• url: Product page URL
• onlineStoreUrl: Direct store URL

Pricing Information

• priceRange: Object containing minimum and maximum variant prices
  • minVariantPrice: Lowest price variant
  • maxVariantPrice: Highest price variant
  • Each price includes amount and currencyCode
• compareAtPriceRange: Original/compare-at pricing information

Product Options

• options: Array of available options (e.g., Gender, Size)
  • Each option includes id, name, and array of values

Variants

• variants: Detailed information about each product variant
  • id: Variant identifier
  • title: Variant description
  • sku: Stock keeping unit
  • availableForSale: Availability status
  • price: Variant-specific pricing
  • selectedOptions: Selected option values
  • metafields: Additional metadata (e.g., instant shipping availability)

Media

• featuredImage: Primary product image
  • url: Image URL
  • width and height: Image dimensions
• images: Array of all product images with similar structure

SEO & Metadata

• seo: SEO information (title, description)
• tags: Product tags and categories
• updatedAt: Last update timestamp

Example Input

{
  "productUrls": [
    { "url": "https://www.kickscrew.com/en-US/products/air-jordan-4-retro-white-cement-2025-fv5029-100" },
    { "url": "https://www.kickscrew.com/en-US/products/wmns-air-jordan-11-low-igloo-ah7860-103" }
  ],
  "countryIso": "US"
}

Example Output

[
  {
    "id": "8120588009667",
    "title": "Air Jordan 4 Retro 'White Cement' 2025 FV5029-100",
    "description": "The iconic Air Jordan 4 \"White Cement,\" a 1989 OG, returns in 2025...",
    "availableForSale": true,
    "productType": "Sneakers",
    "vendor": "Air Jordan",
    "priceRange": {
      "minVariantPrice": {
        "amount": "0.0",
        "currencyCode": "USD"
      },
      "maxVariantPrice": {
        "amount": "2140.0",
        "currencyCode": "USD"
      }
    },
    "options": [
      {
        "name": "Gender",
        "values": ["MENS"]
      },
      {
        "name": "Size",
        "values": [
          "Men's US 7 / Women's US 8.5 / UK 6 / EU 40 / JP 25",
          "Men's US 8 / Women's US 9.5 / UK 7 / EU 41 / JP 26"
        ]
      }
    ],
    "variants": {
      "edges": [
        {
          "node": {
            "id": "gid://shopify/ProductVariant/44243616628931",
            "title": "MENS / Men's US 7 / Women's US 8.5 / UK 6 / EU 40 / JP 25",
            "sku": "FV5029-100-70",
            "availableForSale": true,
            "price": {
              "amount": "230.05",
              "currencyCode": "USD"
            },
            "selectedOptions": [
              {
                "name": "Gender",
                "value": "MENS"
              },
              {
                "name": "Size",
                "value": "Men's US 7 / Women's US 8.5 / UK 6 / EU 40 / JP 25"
              }
            ]
          }
        }
      ]
    },
    "featuredImage": {
      "url": "https://cdn.shopify.com/s/files/1/0603/3031/1875/files/main-square_001c4a03-1189-4a6a-93cb-8eb73718c822.jpg",
      "width": 1316,
      "height": 1316
    }
  }
]

Usage Instructions

Running on Apify Platform

1. Navigate to the Actor: Find the "KICKS CREW Product Description" actor in the Apify Store
2. Configure Input: Set up your input parameters:
   • Add product URLs you want to scrape
   • Select your preferred region for pricing
3. Run the Actor: Click "Start" to begin the scraping process
4. Monitor Progress: Check the actor's log for processing updates
5. Download Results: Access the results in JSON format once completed

API Usage

You can also run this actor programmatically using the Apify API:

const ApifyClient = require('apify-client');

const client = new ApifyClient({
    token: 'YOUR_APIFY_TOKEN'
});

const input = {
    productUrls: [
        { url: 'https://www.kickscrew.com/en-US/products/air-jordan-4-retro-white-cement-2025-fv5029-100' }
    ],
    countryIso: 'US'
};

const run = await client.actor('THE_ACTOR_ID').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();

Rate Limiting and Best Practices

• The actor includes built-in random delays (1-3 seconds) between requests to avoid overwhelming the target website
• Recommended batch sizes: Process 10-50 products per run for optimal performance
• Monitor your usage to stay within reasonable limits and maintain good web scraping ethics

Data Accuracy and Freshness

• Product data is scraped in real-time during actor execution
• Pricing and availability information reflects current website status
• Some products may have dynamic pricing that varies by region and time

Troubleshooting

Common Issues

1. Product Not Found: Ensure URLs are valid and products exist
2. Regional Pricing Issues: Verify the country ISO code is supported
3. Rate Limiting: If requests fail, the actor will automatically retry with delays

Error Handling

The actor includes comprehensive error handling:

• Invalid URLs are logged and skipped
• Network timeouts are automatically retried
• Detailed error messages are provided in the actor logs

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
• Apify Platform: You can also contact us directly through this platform.

---