Fetch one Zazzle product. query is a product URL or a slug that ends with the numeric id, for example https://www.zazzle.com/branded_logo_two_tone_coffee_mug-256528848440338952. The response is a flat object. price and price_display are the same amount. product_id matches the id on the search card.
curl -sS -H "x-api-key: YOUR_API_KEY" "https://api.piloterr.com/v2/zazzle/product?query=https%3A%2F%2Fwww.zazzle.com%2Fbranded_logo_two_tone_coffee_mug-256528848440338952"
| Name |
Detail |
| query |
Required string. Product URL or slug ending in the numeric id. Example: https://www.zazzle.com/branded_logo_two_tone_coffee_mug-256528848440338952. |
| Name |
Detail |
| product_id |
String. Numeric id. |
| title |
String. |
| description |
String or null. |
| brand |
String or null. Store or brand name. |
| image |
String or null. |
| price |
Number or null. |
| price_display |
String or null. Same price as text. |
| currency |
String. For example USD. |
| availability |
String or null. Lowercase schema.org value when the page sends one, otherwise null. |
| url |
String. Product URL without a query string. |
One product. No pagination object.
- A price watcher opens the URL from search and stores
brand, description, and price_display.
- A custom-goods index keeps
currency and availability next to product_id.
- A design catalog accepts a slug that ends in
256528848440338952 without building the search page.
| Name |
Detail |
| 400 |
Missing query, a host other than zazzle.com, or a slug that does not end in the numeric product id. |
| 404 |
Product page had no product data. |
| 401 |
Missing API key. |
| 500 |
The Zazzle request failed. |