Shopify-StockX Price Synchronization Actor

Automatically sync sneaker prices from StockX to your Shopify store with daily automated updates. Perfect for sneaker retailers who want to stay competitive with real-time pricing.

🚀 Features

• Daily Automated Syncing: Schedule to run at 00:00 (midnight) every day
• Easy Product Mapping: Simple interface to link Shopify products with StockX URLs
• Size-Specific Pricing: Map individual size variants to StockX prices
• Flexible Markup: Configure percentage markup on StockX prices
• Price Constraints: Set minimum and maximum price thresholds
• Proxy Support: Built-in datacenter and residential proxy options
• Anti-Bot Protection: Bypass StockX blocking with Apify's proxy infrastructure
• Dry Run Mode: Test configuration without making actual changes
• Detailed Logging: Track all updates and errors
• Enable/Disable Variants: Control which sizes get updated
• Price Change Safety: 50% maximum price change limit prevents errors

📋 Prerequisites

1. Shopify Store with Admin API access
2. Apify Account (free tier available)
3. Product IDs and Variant IDs from your Shopify store
4. StockX URLs for your products

🔧 Setup Instructions

Step 1: Get Shopify Credentials

1. Log into your Shopify Admin panel
2. Go to Settings > Apps and sales channels
3. Click Develop apps (or enable custom app development if needed)
4. Create a new app with these permissions:
   • read_products
   • write_products
5. Copy your Admin API access token
6. Note your shop name (e.g., your-store from your-store.myshopify.com)

Step 2: Get Product and Variant IDs

Finding Product IDs:

1. In Shopify Admin, go to Products
2. Click on a product
3. The URL will show the ID: .../products/1234567890

Finding Variant IDs:

1. While viewing a product, scroll to Variants
2. Click on a variant
3. The URL will show: .../variants/9876543210

Step 3: Configure the Actor

1. Deploy this Actor to your Apify account
2. Go to the Actor's Input tab
3. Fill in the configuration:

{
  "shopifyShopName": "your-sneaker-store",
  "shopifyAccessToken": "shpat_xxxxxxxxxxxxx",
  "productMappings": [
    {
      "shopifyProductId": "1234567890",
      "stockxUrl": "https://stockx.com/air-jordan-1-retro-high-og-chicago",
      "sizeVariants": [
        {
          "shopifyVariantId": "9876543210",
          "stockxSize": "10",
          "enabled": true
        },
        {
          "shopifyVariantId": "9876543211",
          "stockxSize": "10.5",
          "enabled": true
        }
      ]
    }
  ],
  "priceMarkupPercent": 15,
  "minPrice": 50,
  "maxPrice": 5000,
  "dryRun": false,
  "useProxy": true,
  "proxyType": "DATACENTER",
  "proxyCountry": "US"
}

Step 4: Schedule Daily Runs

1. Go to the Actor's Schedules tab
2. Click Create new schedule
3. Configure:
   • Name: "Daily midnight price sync"
   • Cron expression: 0 0 * * * (runs at 00:00 daily)
   • Timezone: Select your timezone
4. Save the schedule

📝 Configuration Options

Required Fields

Field	Description	Example
shopifyShopName	Your Shopify shop name	"your-store"
shopifyAccessToken	Admin API token	"shpat_xxxxx"
productMappings	Array of product configurations	See below

Product Mapping Structure

{
  "shopifyProductId": "1234567890",
  "stockxUrl": "https://stockx.com/product-url",
  "sizeVariants": [
    {
      "shopifyVariantId": "9876543210",
      "stockxSize": "10",
      "enabled": true
    }
  ]
}

Optional Settings

Field	Description	Default
priceMarkupPercent	Markup percentage on StockX price	15
minPrice	Minimum price threshold	50
maxPrice	Maximum price threshold	5000
dryRun	Test mode (no actual updates)	false
useProxy	Enable Apify proxy (recommended)	false
proxyType	DATACENTER (free) or RESIDENTIAL (paid)	DATACENTER
proxyCountry	Two-letter country code (e.g., US, UK, DE)	US

🎯 How It Works

1. Fetch StockX Prices: The Actor visits each StockX URL and extracts prices for specified sizes
2. Apply Markup: Adds your configured markup percentage
3. Apply Constraints: Ensures prices stay within min/max bounds
4. Update Shopify: Updates variant prices via Shopify Admin API
5. Log Results: Saves detailed results to Apify dataset

📊 Output

The Actor produces a detailed report:

{
  "totalProducts": 10,
  "successfulUpdates": 47,
  "failedUpdates": 2,
  "skippedUpdates": 1,
  "errors": [
    {
      "productId": "1234567890",
      "variantId": "9876543210",
      "size": "10",
      "error": "Price not found on StockX"
    }
  ]
}

🔄 Usage Workflow

Initial Setup

1. Start with dryRun: true to test configuration
2. Review the logs to ensure mappings are correct
3. Switch to dryRun: false for live updates

Adding New Products

1. Get Shopify Product ID and Variant IDs
2. Find the StockX URL for the product
3. Add new mapping to productMappings array
4. Save and test with dry run

Disabling Products Temporarily

Set enabled: false for specific variants:

{
  "shopifyVariantId": "9876543210",
  "stockxSize": "10",
  "enabled": false
}

🌐 Proxy Configuration (Recommended)

StockX has aggressive anti-bot protection that may block requests. Using Apify's proxy infrastructure significantly improves reliability.

Proxy Options

1. Datacenter Proxies (Recommended to Start)

{
  "useProxy": true,
  "proxyType": "DATACENTER"
}

• Success Rate: Medium - may get blocked occasionally
• Best For: Testing, less aggressive sites
• Speed: Fast

2. Residential Proxies (Best for StockX)

{
  "useProxy": true,
  "proxyType": "RESIDENTIAL",
  "proxyCountry": "US"
}

• Success Rate: Excellent - appears as real residential users
• Best For: Production use, e-commerce sites with anti-bot protection
• Speed: Medium
• Note: Must be enabled in Apify Console > Proxy

3. No Proxy (Not Recommended)

{
  "useProxy": false
}

• Success Rate: Low - will likely timeout on StockX
• Best For: Testing code structure only

When to Use Each Type

Use Datacenter if:

• Just starting out
• Want to test first
• StockX isn't blocking you

Upgrade to Residential if:

• Getting timeouts or blocks
• Need reliable production scraping
• Running high volume
• Success rate is critical

⚠️ Important Notes

StockX Scraping

• StockX has anti-bot protection - use proxies for reliable scraping
• StockX may update their website structure, requiring selector updates
• Built-in retry logic attempts 3 times per product
• Rate limiting (2-second delays) is included

API Rate Limits

• Shopify: 2 requests per second (built-in delays included)
• Large catalogs may take several minutes to process

Price Updates

• Updates are applied immediately when Actor runs
• Old prices are overwritten without backup
• Consider keeping your own price history

🐛 Troubleshooting

"Price not found on StockX" / Timeouts

Most Common Cause: StockX is blocking your requests

Solutions:

1. Enable proxies: Set useProxy: true
2. Try datacenter first: proxyType: "DATACENTER"
3. If still blocked: Upgrade to proxyType: "RESIDENTIAL"
4. Verify the StockX URL is correct
5. Check that the size exists on StockX
6. StockX selectors may need updating (check logs)

"Proxy authentication failed"

• Enable residential proxy in Apify Console > Proxy
• Verify you have credits in your Apify account
• Check if you're using RESIDENTIAL type correctly

"Failed to update Shopify"

• Verify API token has correct permissions (read_products, write_products)
• Check variant ID is correct
• Ensure product is not archived in Shopify

Actor Times Out

• Reduce number of products per run
• Increase Actor memory allocation (Settings > Timeout & Memory)
• Enable proxies to speed up StockX requests
• Check for slow network responses

🔐 Security

• Access token is stored securely (marked as secret)
• No sensitive data is logged or stored
• API credentials never leave Apify infrastructure

📈 Best Practices

1. Start Small: Begin with 1-2 products to test
2. Enable Proxies: Use useProxy: true with datacenter proxies to start
3. Monitor Regularly: Check logs after first few runs
4. Set Realistic Markups: Ensure profitability
5. Use Price Constraints: Prevent extreme pricing with min/max bounds
6. Keep Mappings Updated: Remove discontinued products
7. Dry Run First: Always test with dryRun: true before going live
8. Price Change Alerts: Review the 50% change limit warnings in logs

🆘 Support

For issues with:

• Apify Actor: Check Apify documentation or community forum
• Shopify API: Refer to Shopify API documentation
• StockX Integration: May require custom scraping updates

📄 License

MIT License - Feel free to modify for your needs

🔄 Updates

Version 1.0.2 (Current)

• ✅ Added Apify proxy support (datacenter & residential)
• ✅ Improved StockX scraping reliability
• ✅ User-configurable proxy settings
• ✅ Geographic proxy targeting (country selection)
• ✅ Enhanced error handling and logging

Version 1.0.0

• Initial release
• Basic price synchronization
• Daily scheduling support
• Dry run mode
• Price constraints and markup configuration