ParseForge Scrapers

TeePublic Scraper

parseforge/teepublic-scraper

AutomationE-commerceDeveloper tools

Scrapes TeePublic product listings from any page, category, or search. Returns each design as a flat row with title, artist, price, tags, and image URLs.

Run this scraper See the API call
Total users
32
Monthly active
0
Total runs
567
Bookmarked
0
Rating
1.0 (1)
Last modified
9 days ago

Overview

ParseForge

TeePublic Scraper

Scrape TeePublic designs from any product page, category, or search, up to a million per run. Every design comes with its title, artist, price, tags, and image URLs. No API key required. Export to CSV, JSON, Excel, or XML.

TeePublic's marketplace has millions of print-on-demand designs, but browsing manually or checking artist catalogs one by one is slow. This Actor reads the public product feeds directly, filtered by product type, category, keyword, or artist name, and returns each matching design in a consistent flat schema.

Who uses it What they scrape TeePublic for
Print-on-demand sellers Monitor trending designs and tags in their niche to inform their own product creation.
Market researchers Track which themes, artists, and product types are gaining traction week over week.
E-commerce analysts Build a catalog of pricing, tag usage, and design popularity for competitive benchmarking.
Artist managers Audit an artist's full catalog across all product types to verify listings and pricing.

What it does

This Actor collects TeePublic product listings by direct URL, category filter, or search query, and returns each design as a flat row.

  • ๐ŸŽฏ Direct URL input: paste any TeePublic product, category, or search results page to scrape exactly that set.
  • ๐Ÿท๏ธ Category and product filters: pick a product type like hoodies or stickers and a category slug like anime or christmas to build the feed.
  • ๐Ÿ” Keyword and artist search: search by general terms or by a specific artist name to narrow results before scraping.
  • ๐Ÿ“Š Sort order control: pull results sorted by relevance, popularity, or newest to match your research question.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

What you can do with TeePublic data

๐Ÿ“ˆ Track trending design themes.

A print-on-demand seller scrapes the 'popular' sort of the anime t-shirts category weekly to see which tags and visual styles are rising.

๐ŸŽจ Audit an artist's catalog.

An artist manager enters an artist name and scrapes all product types to verify every listing is live, priced correctly, and has the right tags.

๐Ÿ’ฐ Monitor competitor pricing.

An e-commerce analyst scrapes a set of design keywords across hoodies, stickers, and mugs to compare how competitors price the same theme on different products.

๐Ÿท๏ธ Build a tag strategy.

A new seller scrapes the top 500 designs in their niche and extracts all tags to understand which keyword combinations correlate with high popularity.

Why choose this scraper

What you get
No API registration Reads the public TeePublic feeds with zero authentication or rate-limit headaches.
Fixed output schema Every design lands as a flat row with title, artist, price, tags, and image URLs, ready for analysis.
Multi-format export Download your dataset as CSV, JSON, Excel, or XML for direct use in spreadsheets or databases.

How it compares

This Actor and the alternative TeePublic Scraper both collect product listings from TeePublic.com. The table below compares the capabilities each listing describes.

Feature ParseForge TeePublic Scraper ๐Ÿ‘•
Direct URL input Yes Not listed
Category and product type filters Yes Not listed
Artist name search Yes Not listed
Keyword search Yes Not listed
Sort by popularity or newest Yes Not listed
Safe search toggle Yes Not listed

Configure the run

Drive the Actor from a direct URL or by combining product type, category, keyword, and artist search. Filters run as each design is read so only matches reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

{
  "maxItems": 10,
  "startUrl": "https://www.teepublic.com/crewneck-sweatshirt/mythical-animals"
}

A larger pull:

{
  "maxItems": 200,
  "startUrl": "https://www.teepublic.com/crewneck-sweatshirt/mythical-animals"
}

Pricing

Pay-per-result: $0.135 per result collected. You pay only for the results written to your dataset.

Results collected Approximate cost
100 results $13.50
1,000 results $135.00
10,000 results $1350.00

New Apify accounts start with $5 in free credit.

Free users

Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.

Run it

  1. Create a free Apify account with $5 in credit.
  2. Open the TeePublic Scraper.
  3. Set your inputs and any filters, then click Start.
  4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.

Use with AI agents (MCP)

Give an AI agent live access to TeePublic through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/teepublic-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting no results?

Check that your category slug is spelled correctly and matches a real TeePublic category. Also confirm you are not using both a direct URL and category filters in the same run.

The Actor scraped fewer designs than my max items setting.

The feed may have fewer designs than your limit. Try broadening your search by removing the keyword or artist filter, or by selecting a larger category.

My artist search returns designs from other artists.

Artist search uses TeePublic's internal artist filter. If the artist name is a common word, some unrelated designs may appear. Try a more specific artist handle.

The safe search filter is not blocking explicit content.

Safe search is a client-side filter applied during the scrape. If some explicit designs still appear, TeePublic's tagging may not flag them. Try adding a negative keyword in your search.

I pasted a URL but the Actor used the category filters instead.

Direct URL and category filters are mutually exclusive. Clear the product type and category fields, and leave keyword and artist search empty, then paste only the start URL.

FAQ

Question Answer
Can I scrape a specific artist's entire catalog? Yes. Use the artist name input to search by designer handle. The Actor will collect all matching designs across the product types and categories you select.
What is the difference between keyword search and artist search? Keyword search looks for terms in the design title and tags. Artist search filters by the designer name. You cannot use both in the same run; pick the one that matches your goal.
How do I scrape a specific product type like stickers or mugs? Select the product type from the dropdown. The Actor builds the correct URL path for that product. Choose 'All Products' to scrape across the entire merchandise range.
Can I scrape a direct URL instead of using filters? Yes. Paste any TeePublic URL into the start URL field. The Actor will scrape that exact page. Direct URLs and category filters are mutually exclusive.
Does this Actor handle NSFW or explicit content? The safe search toggle lets you include or exclude explicit designs. Set it to 'On' to filter mature content client-side during the scrape.
What data fields do I get per design? Each row includes the design title, artist name, price, tags, image URLs, product type, and the source URL. The exact field list is shown in the sample output on the Actor page.
Is there a limit on how many designs I can scrape? You set the maximum number of designs per run, up to one million. The Actor stops when it hits that count or exhausts the feed.
Can I sort results by newest or most popular? Yes. Use the sort dropdown to choose relevance, popular, or newest. The Actor adds the correct query parameter to the URL.
Do I need a TeePublic account or API key? No. The Actor reads the public website feeds. No login, no API registration, and no OAuth tokens are required.
What export formats are supported? You can download your dataset as CSV, JSON, Excel, or XML from the Apify run console.

Related actors

Browse the full ParseForge collection for more scrapers.

๐Ÿ†˜ Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.

โš ๏ธ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by TeePublic, Inc. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

Input

FieldTypeWhat it doesDefault
maxItems integer Maximum number of designs to collect per run. 10
startUrl string Direct URL to scrape from TeePublic. Use this OR category filters below, not both. Example: https://www.teepublic.com/t-shirts/christmas https://www.teepublic.com/crewneck-sweat
productType string (23 options) Select the type of product to scrape. Defaults to t-shirts if not specified. If 'All Products' is selected, URLs will use /{category}-merchandise format. not set
category string Enter a category slug. URL format: /{productType}/{category} (e.g., /t-shirts/christmas, /t-shirts/anime) or /{category}-merchandise if productType is 'All Products' (e.g., /christmas-merchandise). Examples: christmas, music, anime, sci-fi, wu-tang not set
query string Search for products by general terms (titles, tags). Adds ?query= parameter to URL. Cannot be used with 'Artist Search'. Example: christmas, funny not set
artistSearch string Search for products by artist/designer name. Adds ?artist_search=true&query= parameter to URL. Cannot be used with 'Search Query (General)'. Example: lulabyan, legendaryphoenix not set
sortBy string (3 options) Sort order for results. Adds ?sort= parameter to URL. Defaults to relevance if not specified (no parameter added). not set
safeSearch string (2 options) Filter explicit content. This is a client-side filter and doesn't affect URL parameters. Must be handled in the scraper code. not set

Pricing

from $8.20 per 1,000 results

Charged forWhat it isPrice each
Actor Start Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event). $0.09 to $0.135
result Single result in the default dataset. $0.0082 to $0.0098

Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.

API

One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.

POST ยท run and get results
curl -X POST "https://api.apify.com/v2/acts/parseforge~teepublic-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "helloWorld": 123
  }'

Examples

Input that runs as-is.

input.json
{
  "helloWorld": 123
}

Reviews

Rated 1.0 out of 5 across 1 review. Read them on Apify.

Issues

We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.

Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.

Related scrapers

Run TeePublic Scraper on Apify All scrapers