Skip to main content
Piloterr
Back to library

Zazzle Search API

Search Zazzle products by keyword. page maps to the pg parameter. Prices are a number plus a display string.

Active1 credit = 1 requestGET/v2/zazzle/search

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

Search Zazzle products. query is a keyword or a zazzle.com/s/... URL. page maps to the site parameter pg. A product URL, whose slug ends in a long number, returns 400. Use the product endpoint for that URL.

Each card has price as a number and price_display as the same amount in text, for example 15.81 and $15.81. original_price and original_price_display are set only when the page shows a strikethrough price.

QuickstartLink to Quickstart

curl -sS -H "x-api-key: YOUR_API_KEY" "https://api.piloterr.com/v2/zazzle/search?query=coffee%20mug"
curl -sS -H "x-api-key: YOUR_API_KEY" "https://api.piloterr.com/v2/zazzle/search?query=coffee%20mug&page=2"

ParametersLink to Parameters

Name Detail
query Required string. Keyword or a zazzle.com/s URL. Example: coffee mug. A product URL returns 400.
page Optional integer from 1. Example: 2. Maps to pg. Defaults to 1.

Response fieldsLink to Response fields

Name Detail
results[].product_id String. Numeric id at the end of the product slug.
results[].title String.
results[].url String. Product URL. Pass it to the product endpoint.
results[].image String or null.
results[].price Number or null. Current price.
results[].price_display String or null. Same price as shown, for example $15.81.
results[].original_price Number or null. Strikethrough price when the card has one.
results[].original_price_display String or null.
pagination.page Integer.
pagination.per_page Integer. Number of cards parsed on this page.
pagination.total_results Integer or null. The result count on the page. A broad keyword can be in the millions.
pagination.total_pages Integer or null.
pagination.next String or null. Next search URL with pg, for example https://www.zazzle.com/s/coffee+mug?pg=2. Null on the last page.

PaginationLink to Pagination

page=2 requests https://www.zazzle.com/s/coffee+mug?pg=2. pagination.next uses that same pg parameter. Product ids on a page are unique and page 2 does not repeat page 1. next is null only when there is no further page.

Use casesLink to Use cases

  • A merch seller tracks coffee mug prices and checks that price matches price_display.
  • A catalog walks page=2, which Zazzle calls pg=2, until next is null.
  • A store monitor collects each url and opens it with the product endpoint for the brand and description.

Error codesLink to Error codes

Name Detail
400 Missing query, a host other than zazzle.com, or a product URL sent to search.
404 No products, or page past the last page.
401 Missing API key.
500 The Zazzle request failed.

Related APIs

Expand your data capabilities with these complementary tools.

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included