TeePublic Scraper

Overview

This actor scrapes detailed product listings from TeePublic.com search pages. It's built for e-commerce data extraction, returning clean JSON data for market research, price tracking, or catalog building.

Key Features

• Product Data Extraction: Captures design IDs, titles, designer info, pricing (multiple currencies), URLs, image links, tags, categories, sale status, and descriptions.
• Search Handling: Supports multiple search URLs and automatic pagination.
• Configurable Limits: Optional maxItems parameter to control scrape volume.
• Polite Scraping: Built-in rate limiting, delays, retry logic, and respect for robots.txt.
• Structured Output: Returns consistent JSON with timestamps and source URL context.

How to Use

1. Create a new task for the TeePublic Scraper actor.
2. Configure the input (see below).
3. Run the actor. Results are available in the Storage tab as JSON, JSONL, Excel, CSV, HTML, or XML.

Input/Output

Input Parameters:
- searchUrls (array, required): List of TeePublic search URLs to scrape.
- maxItems (number, optional): Maximum items to scrape per run. Default is unlimited.

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

Output Sample:
The actor outputs an array of items. Each contains the source searchUrl, product listing details, and a scrapedAt timestamp.

[
  {
    "searchUrl": "https://www.teepublic.com/hoodie?...",
    "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/...",
      "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"
  }
]