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 json { "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 json { "collection": "nike" } ### Filtered Search with Pagination json { "collection": "nike", "query": "Air Jordan", "page": 2, "hitsPerPage": 12, "gender": "men", "minPrice": 150, "maxPrice": 300, "sizes": "10" } ### Color and Brand Specific Search json { "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. ---