teepublic.com APIteepublic.com ↗
Search TeePublic products, retrieve artist profiles, browse product types, and get detailed pricing and color options via the TeePublic API.
curl -X GET 'https://api.parse.bot/scraper/119fee6a-e764-4179-bb13-c099c8937222/search_products?query=cat' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on TeePublic by keyword. Returns paginated results with product titles, prices, artist names, and images.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| sort | string | Sort order. Accepted values: popular, newest, relevance. |
| queryrequired | string | Search keyword. |
| product_type | string | The type of product to search. Common values include t-shirts, hoodie, mug, hats, kids-t-shirt, socks, bags. |
{
"type": "object",
"fields": {
"products": "array of product objects with title, product_url, artist, price, is_on_sale, image_url",
"total_pages_approx": "integer, approximate number of pages available"
},
"sample": {
"data": {
"page": "1",
"query": "cat",
"products": [
{
"price": "$16",
"title": "Kawaii Ramen Cat Retro Japanese Noodles Artwork T-Shirt",
"artist": "ThatHorrorBozo",
"image_url": "https://images.teepublic.com/derived/production/designs/81397466_0/1759808028/i_p:c_191919,s_313,q_90.jpg",
"artist_url": null,
"is_on_sale": true,
"product_url": "https://www.teepublic.com/t-shirt/81397466-kawaii-ramen-cat-retro-japanese-noodles-artwork"
}
],
"total_pages_approx": 7
},
"status": "success"
}
}About the teepublic.com API
The TeePublic API covers 6 endpoints for querying the TeePublic print-on-demand marketplace, returning product listings with pricing, color options, and artist attribution. The search_products endpoint accepts keyword queries with optional filters for product type and sort order, while get_product_details returns per-product fields including sizes, fits, styles, and currency. Artist discovery is handled through dedicated profile, designs, and featured-artist endpoints.
Product Search and Detail
The search_products endpoint accepts a required query string and optional product_type parameter — valid values include t-shirts, hoodie, mug, hats, kids-t-shirt, socks, and bags. Results are paginated via the page parameter and can be sorted by popular, newest, or relevance. Each product object in the response includes title, product_url, artist, price, is_on_sale, and image_url, plus a total_pages_approx integer for pagination planning.
get_product_details takes a full URL or path slug and returns granular per-product data: sku, sizes, colors, fits, styles, price, currency, and artist. Some fields like fits and styles may return empty arrays depending on the product type, so consumers should handle those gracefully.
Artist Data
get_artist_profile accepts a username and returns the artist's name, bio, avatar_url, and social_links array. get_artist_designs accepts the same username with an optional page parameter and returns paginated product listings for that storefront, including is_on_sale flags. get_featured_artists requires no inputs and returns TeePublic's weekly curated list of highlighted creators with their username, url, avatar_url, and social_links.
Navigation and Category Data
list_product_types takes no inputs and returns an array of objects each containing a name (display label) and slug (URL path segment). The output mixes product type categories and topic categories as they appear in TeePublic's site navigation, so slugs are suitable for use as product_type values in search queries.
- Build a product discovery tool filtered by product type (e.g. mugs or socks) using
search_productswith theproduct_typeparameter. - Track sale status across a set of designs by polling
is_on_salefromsearch_productsorget_artist_designsresults. - Aggregate artist bios, avatars, and social links from
get_artist_profileto build a creator directory. - Fetch full size and color availability for specific products using
get_product_detailsto power a gift recommendation tool. - Display weekly featured TeePublic creators in a newsletter or digest using
get_featured_artists. - Map out TeePublic's product taxonomy by pulling
nameandslugpairs fromlist_product_typesfor category navigation. - Compare an artist's full catalog pricing and sale flags by paginating through
get_artist_designsresults.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does TeePublic have an official developer API?+
What does `get_product_details` return beyond basic pricing?+
get_product_details returns the product sku, available sizes (as an array of strings), colors, fits, styles, artist name, price, and currency. Note that fits and styles may be empty arrays for product types that don't support those options, such as mugs or bags.Does the API return customer reviews or ratings for products?+
How does pagination work across endpoints that support it?+
search_products and get_artist_designs both accept a page integer parameter and return a total_pages_approx integer in the response. This value is approximate, so iterating until results are empty is more reliable than stopping exactly at total_pages_approx.