# Zazzle Product ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/zazzle/product` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 2 credits per call | | **Documentation** | https://www.piloterr.com/library/zazzle-product | ## Description Fetch one Zazzle product by its product URL or by a slug that ends in the numeric product id. ## Authentication - **Key Name:** `x-api-key` - **Location:** HTTP Header - **Get an API key:** https://app.piloterr.com/register ## Example Request ```bash curl --location --request GET 'https://api.piloterr.com/v2/zazzle/product' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### two-tone mug ```json { "url": "https://www.zazzle.com/branded_logo_two_tone_coffee_mug-256528848440338952", "brand": "studioZ", "image": "https://rlv.zcache.com/svc/view?max_dim=1000&realview=117426885324810002", "price": 15.81, "title": "Branded Logo Two-Tone Coffee Mug", "currency": "USD", "product_id": "256528848440338952", "description": "Looking for custom mugs? This mug fits the bill. Personalize it with your own logo for a look that's completely yours. Great for everyday use at home, it's ready whenever you are. It's an easy way to make it feel like yours.", "availability": null, "price_display": "$15.81" } ``` ## Documentation ## Overview 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. ## Quickstart ``` 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" ``` ## Parameters | 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`. | ## Response fields | 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. | ## Pagination One product. No `pagination` object. ## Use cases - 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. ## Error codes | 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. | ## Related endpoints - [Zazzle Search](https://www.piloterr.com/library/zazzle-search)