KICKS CREW Products By Collection - Apify Actor Documentation

Overview

The KICKS CREW Products By Collection actor is a powerful web scraping tool designed to extract product information from the KICKS CREW sneaker marketplace. This actor allows you to search for sneakers and footwear products within specific collections, apply various filters, and retrieve detailed product data including prices, sizes, colors, and availability.

Key Features

• Collection-based search: Search within specific product collections (e.g., Nike, Adidas, Jordan)
• Advanced filtering: Filter by gender, brand, color, size, price range, release year, and product type
• Pagination support: Navigate through multiple pages of results
• Comprehensive product data: Extract detailed information including pricing, availability, images, and specifications
• Flexible output: Returns structured JSON data with search metadata

Input Parameters

Required Parameters

Parameter	Type	Description	Example
collection	string	The product collection to search within	"nike"

Optional Parameters

Parameter	Type	Description	Default	Example
query	string	Search term or keywords to find products	""	"Air Jordan 1"
page	integer	Page number for pagination (1-based)	1	2
hitsPerPage	integer	Number of products per page (1-100)	24	48
gender	string	Filter by gender category	null	"men", "women", "kids", "unisex"
brand	string	Filter by brand name	null	"Nike"
mainColor	string	Filter by main color	null	"black"
productType	string	Filter by product type	null	"sneakers"
releaseYear	string	Filter by release year	null	"2024"
sizes	string	Filter by available size	null	"10"
minPrice	integer	Minimum price filter (inclusive)	null	100
maxPrice	integer	Maximum price filter (inclusive)	null	500

Output Format

The actor returns a structured JSON object containing:

Main Structure

{
  "products": [...],
  "searchMetadata": {
    "query": "search term",
    "page": 1,
    "hitsPerPage": 24,
    "totalResults": 24,
    "appliedFilters": {...},
    "searchedAt": "2025-06-23T10:30:09.011Z"
  }
}

Product Object Structure

Each product in the products array contains:

Field	Type	Description
product_id	string	Unique product identifier
title	string	Product name and colorway
brand	string	Brand name (e.g., "Nike", "Adidas")
model_no	string	Official model number
gender	string	Target gender category
image	string	Product image URL
main_color	string	Primary color
colorway	array	Array of colors in the colorway
nickname	string	Popular nickname for the colorway
series	string	Product series/line
release_date	integer	Release date (YYYYMMDD format)
release_year	integer	Release year
occasion	string	Intended use (e.g., "basketball", "lifestyle")
sizes	array	Available sizes
lowest_price	integer	Lowest available price
highest_price	integer	Highest available price
inventory	integer	Availability status
url	string	Direct product page URL

Usage Examples

Basic Collection Search

{
  "collection": "nike"
}

Filtered Search with Pagination

{
  "collection": "nike",
  "query": "Air Jordan",
  "page": 2,
  "hitsPerPage": 12,
  "gender": "men",
  "minPrice": 150,
  "maxPrice": 300,
  "sizes": "10"
}

Color and Brand Specific Search

{
  "collection": "adidas",
  "mainColor": "black",
  "brand": "Adidas",
  "productType": "sneakers",
  "releaseYear": "2024"
}

Output Data Storage

The actor stores data in two locations:

1. Dataset: Complete search results with metadata
2. Key-Value Store:
   • SEARCH_SUMMARY: Summary of successful searches
   • SEARCH_ERROR: Error information if the search fails

Common Use Cases

E-commerce Price Monitoring

Monitor sneaker prices across different collections and track price changes over time.

Inventory Tracking

Track product availability and size options for specific sneaker models.

Market Research

Analyze sneaker trends, popular colorways, and release patterns within specific collections.

Product Catalog Building

Build comprehensive product catalogs with detailed specifications and pricing information.

Error Handling

The actor includes comprehensive error handling:

• Invalid input parameters are validated before processing
• Network errors are caught and logged
• Failed searches are recorded in the key-value store with error details
• Detailed error messages help diagnose issues

Performance Considerations

• Rate Limiting: The actor respects the target website's rate limits
• Pagination: Use pagination for large result sets to avoid timeouts
• Filtering: Apply filters to reduce result sets and improve performance
• Concurrent Runs: Be mindful of running multiple instances simultaneously

Limitations

• Results are limited to products available on KICKS CREW
• Some filters may not be available for all collections
• Price information reflects KICKS CREW pricing and may vary from other retailers
• Product availability is subject to real-time inventory changes

Support and Troubleshooting

Common Issues

1. No Results Found: Check collection name spelling and filter combinations
2. Timeout Errors: Reduce hitsPerPage or add more specific filters
3. Invalid Filters: Ensure filter values match expected formats

Best Practices

• Start with broad searches and progressively add filters
• Use pagination for large result sets
• Regularly update collection names as they may change
• Monitor for changes in the website structure that might affect data extraction

Data Quality

The extracted data includes:

• Real-time pricing information
• Current inventory status
• High-quality product images
• Accurate product specifications
• Direct links to product pages

This actor provides reliable, up-to-date information for sneaker enthusiasts, retailers, and market researchers looking to access KICKS CREW's extensive product catalog programmatically.

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.

---