# Zoro Product ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/zoro/product` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 2 credits per call | | **Documentation** | https://www.piloterr.com/library/zoro-product | ## Description Get a Zoro product page: title, brand, USD price, Zoro number, manufacturer number, images, and specifications. ## 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/zoro/product' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### 3M SecureFit SF201SGAF-BLU ```json { "url": "https://www.zoro.com/3m-safety-glasses-securefit-200-series-scotchgard-anti-fog-frameless-blue-temples-clear-lens-sf201sgaf-blu/i/G1937045/", "gtin": "076308944872", "brand": "3M", "image": "https://www.zoro.com/static/cms/product/large/490a8043-20d5-41d6-9c12-44adaae21e83.jpeg", "price": 8.99, "title": "Safety Glasses, SecureFit 200 Series, Scotchgard Anti-Fog, Frameless, Blue Temples, Clear Lens", "images": [ "https://www.zoro.com/static/cms/product/large/490a8043-20d5-41d6-9c12-44adaae21e83.jpeg", "https://www.zoro.com/static/cms/product/large/Grainger_493X64xx2xx5a17d9.jpeg", "https://www.zoro.com/static/cms/product/large/Grainger_493X64xxAS01xx29c38a.jpeg", "https://www.zoro.com/static/cms/product/large/db6a92db-fa24-4dfa-9b4b-5da0f9676b7c.jpeg", "https://www.zoro.com/static/cms/product/large/Grainger_493X64xx3xx30127e.jpeg" ], "mfr_no": "SF201SGAF-BLU", "zoro_no": "G1937045", "currency": "USD", "in_stock": true, "price_unit": "ea", "breadcrumbs": [ { "url": "https://www.zoro.com/safety/c/z1/", "name": "Safety" }, { "url": "https://www.zoro.com/personal-protective-equipment-ppe/c/13/", "name": "Personal Protective Equipment (PPE)" }, { "url": "https://www.zoro.com/eye-protection/c/4447/", "name": "Eye Protection" }, { "url": "https://www.zoro.com/safety-glasses/c/6214/", "name": "Safety Glasses" } ], "description": "Safety Glasses, Series SecureFit(TM) 200, Gender Unisex, Lens Color Clear, Polarized Lens No, Lens Coating Scotchgard(TM) Anti-Fog, No Foam Lined, Eyewear Frame Design Traditional, Eyewear Frame Style Frameless, Frame Color Clear, Eyewear Size Universal, Frame Material Polycarbonate, Lens Material Polycarbonate, Temple Color Blue, Temple Style Pressure Diffusion, Photochromatic Lens No, Metal Detectable No, X-Ray Detectable No, UV Protection 99.9 Percent, Includes Not Applicable", "price_display": "$8.99", "specifications": { "Item": "Safety Glasses", "MFR #": "SF201SGAF-BLU", "UPC #": "076308944872", "Gender": "Unisex", "Series": "SecureFit 200", "Zoro #": "G1937045", "Features": "3M™ Pressure Diffusion Temple Technology; Impact-resistant Lens", "Used For": "Assembly, Construction, Food & Beverage Manufacturing, General Manufacturing, Repair & Operation (MO)", "Arm Color": "Blue", "Standards": "ANSI-ISEA Z87.1-2020, CSA Z94.3", "Foam Lined": "No", "Frame Type": "Frameless", "Hinge Type": "Barrel", "Lens Color": "Clear", "Application": "General Purpose", "Frame Color": "Blue", "Frame Style": "Wraparound", "Arm Material": "Xylex", "Arm Tip Type": "Wraparound", "Eyewear Size": "Universal", "Lens Coating": "Scotchgard Anti-Fog & Anti-Scratch", "Lens Material": "Polycarbonate", "UV Protection": "99.99% UVA/UVB", "Frame Material": "Polycarbonate", "Metal Detectable": "No", "X-Ray Detectable": "No", "Adjustable Pieces": "Temple", "Country of Origin": "Taiwan, Province of China", "Photochromatic Lens": "No", "Temple Tip Features": "Flexible", "Includes Brow Lining": "No", "Nose Bridge Material": "Polycarbonate", "Temple Adjustment Type": "Pressure Diffusion", "Temple-to-Temple Width": "5 1/2 in", "Includes Eye Socket Lining": "No", "Meets High Impact Standard": "High Impact Standard ANSI Z87+", "For Small Heads Designation": "Not Rated for Small Heads", "Includes Anti-Fog Lens Coating": "Yes", "Includes Polarized Lens Coating": "No", "Includes Scratch-Resistant Lens Coating": "Yes", "Ultra-Violet Scale Protection Designation": "U6", "Infra-Red Light Scale Protection Designation": "R0" } } ``` ## Documentation ## Overview The **Zoro Product** endpoint returns one Zoro product page as a flat object: title, brand, USD price, Zoro number, manufacturer number, GTIN, images, breadcrumbs, and specifications. ## Quickstart ``` GET https://api.piloterr.com/v2/zoro/product?query=https://www.zoro.com/3m-safety-glasses-securefit-200-series-scotchgard-anti-fog-frameless-blue-temples-clear-lens-sf201sgaf-blu/i/G1937045/ ``` ## Parameters | Parameter | Type | Required | Description | |---|---|---|---| | `query` | string | yes | Product URL, or a path containing `/i/G...`. A search URL returns 400. | | `return_page_source` | boolean | no | Return rendered HTML instead of JSON. | ## Response fields | Field | Type | Description | |---|---|---| | `zoro_no` | string | Zoro item number | | `mfr_no` | string | Manufacturer number | | `title` | string | Product title | | `brand` | string | Brand | | `url` | string | Canonical product URL | | `price` | number | Unit price in USD | | `price_display` | string | Price label, such as `$8.99` | | `currency` | string | `USD` | | `price_unit` | string | Unit, such as `ea` | | `gtin` | string | UPC or GTIN when present | | `in_stock` | boolean | From the product availability | | `description` | string | Product description | | `image` | string | Primary image | | `images` | string[] | Gallery images | | `breadcrumbs` | array | Category trail (`name`, `url`) | | `specifications` | object | Label and value pairs from the spec table | | `package_quantity` | integer | Pack size when the page shows a multiple | | `package_price` | number | Pack price when shown | | `package_price_display` | string | Pack price label | Missing fields are omitted. There is no `results` wrapper. ## Use cases - Pull specs and the current unit price for a known Zoro product URL. - Store the Zoro number and manufacturer number for reorder matching. ## Error codes | Code | Meaning | |---|---| | `400` | Empty query, a non-Zoro URL, or a URL that is not a product | | `404` | The page had no product data | | `500` | The page could not be rendered | ## Related endpoints - [Zoro Search](https://www.piloterr.com/library/zoro-search)