KICKS CREW Similar Products Actor

Overview

The KICKS CREW Similar Products actor is deployed on Apify and designed to fetch product recommendations from the KICKS CREW sneaker marketplace. Given a product model code, the actor returns a list of similar products with detailed information including pricing, images, and product specifications.

Actor Information

• Actor Name: KICKS CREW Similar Products
• Platform: Apify
• Purpose: Retrieve similar product recommendations based on a product model code
• Output Format: JSON array with product details

Input Configuration

The actor accepts a single required parameter:

Input Schema

{
  "title": "KICKS CREW Product Description Input",
  "type": "object",
  "schemaVersion": 1,
  "properties": {
    "model": {
      "title": "Product Model",
      "type": "string",
      "description": "The Product Model.",
      "prefill": "ah7860-103",
      "editor": "textfield"
    }
  },
  "required": ["model"]
}

Parameters

Parameter	Type	Required	Description	Default Value
model	string	Yes	The product model code to find similar products for	ah7860-103

How to Get the Product Model

The product model is typically a unique identifier used by sneaker brands and retailers. Here are common ways to find product model codes:

1. From Product Pages

• Visit the KICKS CREW website or other sneaker retailers
• Look for the product model code in the product details section
• It's usually displayed near the product title or in the specifications

2. Common Model Code Formats

• Nike/Jordan: Format like AH7860-103, AR0715-441, DV2629-106
• Adidas: Format like GZ2864, FZ5000
• Other brands: Each brand has its own naming convention

3. From Sneaker Databases

• Use sneaker identification websites
• Check official brand websites
• Look at the product label or box for the style code

4. Example Model Codes

• ah7860-103 - Air Jordan 11 Retro Low (default example)
• AR0715-441 - Air Jordan 11 Retro 'Midnight Navy Velvet'
• DV2629-106 - Air Jordan 11 CMFT Low 'White Black Blue Tint'

Usage Example

Input

{
  "model": "ah7860-103"
}

Running the Actor

1. Go to your Apify console
2. Find the "KICKS CREW Similar Products" actor
3. Click "Start new run"
4. Enter the product model in the input field
5. Click "Start"

Output Structure

The actor returns a JSON array containing product recommendation data:

Output Schema

[
  {
    "product": {
      "spu": "string",
      "matchingRules": [],
      "items": [
        {
          "spu": "string",
          "title": "string",
          "handle": "string",
          "brand": "string",
          "productType": "string",
          "imageUrl": "string",
          "color": "string",
          "lowest_price": number
        }
      ]
    }
  }
]

Field Descriptions

Field	Type	Description
product.spu	string	The original product model code searched for
product.matchingRules	array	Rules used for matching (typically empty)
product.items	array	Array of similar products found
items[].spu	string	Product model code of the similar item
items[].title	string	Full product name/title
items[].handle	string	URL-friendly product identifier
items[].brand	string	Brand name (e.g., "Air Jordan")
items[].productType	string	Product category (e.g., "Sneakers")
items[].imageUrl	string	URL to product image
items[].color	string	Primary color of the product
items[].lowest_price	number	Lowest available price in USD

Example Output

[
  {
    "product": {
      "spu": "ah7860-103",
      "matchingRules": [],
      "items": [
        {
          "spu": "AR0715-441",
          "title": "(WMNS) Air Jordan 11 Retro 'Midnight Navy Velvet'",
          "handle": "wmns-air-jordan-11-retro-midnight-navy-ar0715-441",
          "brand": "Air Jordan",
          "productType": "Sneakers",
          "imageUrl": "https://cdn.shopify.com/s/files/1/0603/3031/1875/files/main-square_855cd1dd-bb5d-4959-a6cb-9fc66f549544_x480.jpg?v=1706156612",
          "color": "blue",
          "lowest_price": 116
        },
        {
          "spu": "AH7860-160",
          "title": "(WMNS) Air Jordan 11 Retro Low 'Legend Pink'",
          "handle": "wmns-air-jordan-11-retro-low-legend-pink-ah7860-160",
          "brand": "Air Jordan",
          "productType": "Sneakers",
          "imageUrl": "https://cdn.shopify.com/s/files/1/0603/3031/1875/files/main-square_09c6d29e-30cf-4643-bd56-48064cf2ece3_x480.jpg?v=1713146102",
          "color": "pink",
          "lowest_price": 106
        }
      ]
    }
  }
]

Features

Random Delay

The actor implements a random delay mechanism (1-2 seconds) between requests to avoid overwhelming the target server and maintain ethical scraping practices.

Error Handling

Comprehensive error handling ensures that any issues during execution are properly logged and reported.

Rate Limiting and Best Practices

• Random Delays: 1-2 second delays between requests
• Single Request: Actor processes one model per run
• Error Logging: Comprehensive error reporting for debugging

Limitations

• Only processes one product model per actor run
• Requires valid KICKS CREW product model codes
• Dependent on KICKS CREW API availability
• Results limited to what's available in KICKS CREW's database

Troubleshooting

Common Issues

1. Invalid Model Code: Ensure the product model exists in KICKS CREW's database
2. Network Errors: Check internet connectivity and KICKS CREW website status
3. Empty Results: The product model might not have similar products available

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.

---