Sneakers Search Actor - Documentation

Overview

The Sneakers Search Actor is a powerful web scraping tool designed to aggregate sneaker resale prices and product information from multiple leading marketplaces. This actor retrieves comprehensive sneaker data including pricing from StockX, Flight Club, GOAT, and Stadium Goods, along with detailed product specifications, images, and direct purchase links.

Key Features

• Multi-Platform Price Comparison: Automatically fetches the lowest resell prices from StockX, Flight Club, GOAT, and Stadium Goods
• Comprehensive Product Data: Returns detailed sneaker information including brand, model, colorway, style ID, and release date
• High-Quality Images: Retrieves multiple product images from various angles
• Direct Resell Links: Provides direct URLs to each marketplace for immediate purchasing
• Flexible Search: Search for any sneaker by name, model, or keyword
• Customizable Results: Control the number of results returned per search

Input Parameters

Required Parameters

Parameter	Type	Description	Default
query	string	Search term for sneakers (e.g., "yeezy", "jordan 1", "nike dunk")	"yeezy"
limit	integer	Maximum number of sneaker results to return (minimum: 1)	5

Input Example

{
  "query": "yeezy",
  "limit": 5
}

Output Format

The actor returns detailed JSON data for each sneaker found, including:

Price Information

• lowestResellPrice: Object containing lowest prices from each marketplace (USD)
  • stockX: StockX price
  • flightClub: Flight Club price
  • goat: GOAT price
  • stadiumGoods: Stadium Goods price

Product Details

• shoeName: Full product name
• brand: Manufacturer (e.g., "adidas", "Nike")
• silhouette: Sneaker model line
• styleID: Official style/SKU number
• colorway: Color description
• retailPrice: Original MSRP in USD
• releaseDate: Official release date (YYYY-MM-DD format)
• description: Detailed product description

Media & Links

• thumbnail: Primary product image URL
• imageLinks: Array of high-resolution product images
• resellLinks: Object containing direct URLs to:
  • StockX listing
  • Flight Club listing
  • GOAT listing
  • Stadium Goods listing

Output Example

{
  "lowestResellPrice": {
    "stockX": 110,
    "flightClub": 116,
    "goat": 55,
    "stadiumGoods": 192
  },
  "imageLinks": [
    "https://www.stadiumgoods.com/cdn/shop/files/w7mmzb7wp0vif616hbe2yzenmh24.png",
    "https://www.stadiumgoods.com/cdn/shop/files/sjftt75ayqdu5mbziox3vguj3aqx.png"
  ],
  "shoeName": "adidas Yeezy Boost 350 V2 Onyx",
  "brand": "adidas",
  "silhouette": "adidas Yeezy Boost 350 V2",
  "styleID": "HQ4540",
  "colorway": "Onyx/Onyx/Onyx",
  "retailPrice": 230,
  "releaseDate": "2022-03-05",
  "description": "A monochromatic 'Onyx' hue envelops the latest Yeezy Boost 350 V2...",
  "resellLinks": {
    "stockX": "https://stockx.com/adidas-yeezy-boost-350-v2-onyx",
    "flightClub": "https://www.flightclub.com/yeezy-boost-350-v2-onyx-hq4540",
    "goat": "http://www.goat.com/sneakers/yeezy-boost-350-v2-onyx-hq4540",
    "stadiumGoods": "https://www.stadiumgoods.com/products/yeezy-boost-350-v2-onyx-066114"
  },
  "currency": "USD"
}

Use Cases

1. Sneaker Resale Price Monitoring

Track price fluctuations across multiple marketplaces to identify the best deals or optimal selling times. Perfect for resellers looking to maximize profit margins.

Example Input:

{
  "query": "jordan 1 chicago",
  "limit": 10
}

2. Market Research & Analytics

Aggregate pricing data for business intelligence, trend analysis, or academic research on sneaker market dynamics.

Example Input:

{
  "query": "nike dunk low",
  "limit": 20
}

3. Price Comparison Shopping

Quickly compare prices across all major resale platforms to find the lowest available price before making a purchase.

Example Input:

{
  "query": "air max 97",
  "limit": 5
}

4. Inventory Management for Resellers

Monitor your inventory's current market value across multiple platforms to make informed pricing decisions.

Example Input:

{
  "query": "off white",
  "limit": 15
}

5. Sneaker Collection Valuation

Determine the current market value of your personal sneaker collection by searching for specific models.

Example Input:

{
  "query": "travis scott",
  "limit": 8
}

6. E-commerce Integration

Integrate real-time sneaker pricing and availability data into your own website or application.

Example Input:

{
  "query": "new balance 550",
  "limit": 12
}

7. Investment Tracking

Monitor high-value sneakers as alternative investments, tracking appreciation or depreciation over time.

Example Input:

{
  "query": "yeezy 750",
  "limit": 5
}

How to Use

1. Configure Input Parameters: Set your search query and desired result limit
2. Run the Actor: Execute the scraping process
3. Retrieve Results: Access the structured JSON data from the actor's dataset
4. Analyze Data: Use the pricing, images, and links for your specific use case

Search Tips

• Be Specific: Use complete model names for better results (e.g., "Jordan 1 Retro High Chicago" vs "Jordan")
• Use Official Names: Reference sneakers by their official release names when possible
• Try Variations: If results aren't what you expect, try alternative search terms (e.g., "AJ1" vs "Air Jordan 1")
• Popular Searches: Yeezy, Jordan, Dunk, Air Max, Off-White, Travis Scott, Fear of God

Data Accuracy

All pricing data is retrieved in real-time from official marketplace sources, ensuring up-to-date and accurate information. The actor aggregates data from:

• StockX: Leading sneaker marketplace with verified authentication
• Flight Club: Premier sneaker consignment store
• GOAT: Authenticated sneaker marketplace
• Stadium Goods: Luxury sneaker and streetwear retailer

Best Practices

• Set appropriate limits to balance data completeness with processing time
• Run the actor regularly for price monitoring use cases
• Store historical data to track price trends over time
• Combine with other data sources for comprehensive market analysis

Error Handling

The actor includes robust error handling and will return error information if issues occur during scraping:

{
  "data": null,
  "error": "Error message description",
  "timestamp": "2025-02-12T10:30:00.000Z"
}

Technical Requirements

• Apify platform account
• Basic understanding of JSON data structures
• API integration knowledge (for automated workflows)

Support & Updates

This actor is regularly maintained to ensure compatibility with marketplace changes and data structure updates. For issues or feature requests, please use the Apify platform's support channels or:

• contact us via Telegram at @pintoflow