TeePublic Scraper 👕

Powerful scraper for extracting detailed product information from TeePublic.com. Get comprehensive data about designs, products, pricing, and more!

🎯 Use Cases

• Market research and competitor analysis
• Price monitoring and tracking
• Design trend analysis
• Product catalog building
• Inventory monitoring

✨ Features

• Extract detailed product information including:
  • Design IDs and titles
  • Designer information
  • Product pricing (multiple currencies)
  • Product URLs and image links
  • Product tags and categories
  • Sale status
  • Product descriptions
• Support for pagination
• Configurable number of items to scrape
• Multiple search URLs support
• Built-in rate limiting and retry mechanism
• Clean, structured JSON output

💎 Output Data

The actor provides detailed information for each product listing, including:

• Search URL context
• Design details (ID, title, designer)
• Product information (ID, name, URL)
• Pricing details (current price, USD price, currency)
• Image URLs
• Product tags and categories
• Sale status
• Timestamp of scraping

🔧 Input Parameters

The actor accepts the following input parameters:

• searchUrls: Array of TeePublic search URLs to scrape
• maxItems: Maximum number of items to scrape (optional, default: unlimited)

🚀 Getting Started

1. Create a new task for the TeePublic Scraper actor
2. Provide the search URLs you want to scrape
3. Set the maximum number of items (optional)
4. Run the actor and get your data!

📝 Notes

• The actor respects TeePublic's robots.txt and implements polite scraping
• Built-in delays and randomization to prevent blocking
• Automatically handles pagination

Input Example

A full explanation of an input example in JSON.

{
    "searchUrls": [
        "https://www.teepublic.com/hoodie?canvas_subclass=classic-hoodie&gender=unisex&query=twin+peaks"
    ],
    "maxItems": 50
}

Output sample

The results will be wrapped into a dataset which you can always find in the Storage tab. Here's an excerpt from the data you'd get if you apply the input parameters above:

And here is the same data but in JSON. You can choose in which format to download your data: JSON, JSONL, Excel spreadsheet, HTML table, CSV, or XML.

[
    {
        "searchUrl": "https://www.teepublic.com/hoodie?canvas_subclass=classic-hoodie&gender=unisex&query=twin+peaks",
        "listing": {
            "designId": "57531099",
            "designTitle": "Twin Peaks - Walk With Me",
            "designerName": "DesignedbyWizards",
            "productId": "758",
            "url": "https://www.teepublic.com/hoodie/57531099-twin-peaks-walk-with-me",
            "price": {
                "current": "26.88",
                "usd": "32.00",
                "currency": "EUR"
            },
            "name": "Small, Classic Hoodie, Black",
            "imageUrl": "https://res.cloudinary.com/teepublic/image/private/s--9RNKvcux--/t_Resized Artwork/c_crop,x_10,y_10/c_fit,h_620/c_crop,g_north_west,h_620,w_465,x_-25,y_0/g_north_west,u_upload:v1446840652:production:blanks:ymwlojdlb9pdlxgcmck4,x_-416,y_-276/b_rgb:eeeeee/c_limit,f_auto,h_313,q_auto:good:420,w_313/v1707656179/production/designs/57531099_0",
            "mainTag": "Twin Peaks Hoodie",
            "description": "Twin Peaks - Walk With Me",
            "tags": "agent cooper, black lodge, coffee, dale cooper, damn fine coffee",
            "supplementalInfo": "",
            "onSale": true
        },
        "scrapedAt": "2025-01-21T04:05:38.602Z"
    },
    ...
]