Victorinox APIvictorinox.com ↗
Access Victorinox product listings, categories, and material classifications via 3 endpoints. Retrieve product specs, materials, and subcategory data programmatically.
What is the Victorinox API?
The Victorinox API gives developers structured access to the full Victorinox product catalog across 3 endpoints, returning product identifiers, names, SEO paths, image URLs, and detailed material classifications. The get_product_materials endpoint exposes granular classification data — including material composition, size, color, and function attributes — for any individual product identified via list_products.
curl -X GET 'https://api.parse.bot/scraper/f24a72fa-f7fa-4dde-8ab1-a86a5ff46eb9/list_products?page=1&limit=5&category=SAK' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace victorinox-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Victorinox SDK — browse categories, list products, inspect materials."""
from parse_apis.victorinox_com_api import Victorinox, Category, InputFormatInvalid
client = Victorinox()
# Browse all top-level product categories and their subcategories.
for cat in client.product_categories.list(limit=10):
subs = ", ".join(s.name for s in cat.subcategories)
print(f"{cat.name} ({cat.code}): {subs}")
# List Swiss Army Knives, capped at 5 total items.
for product in client.products.list(category=Category.SAK, limit=5):
print(product.name, product.subcategory)
# Drill into the first product's material and classification details.
product = client.products.list(category=Category.SAK, limit=1).first()
if product is not None:
try:
detail = product.materials()
except InputFormatInvalid as e:
print("Bad input:", e.message)
else:
print(detail.product_name, detail.materials)
# Walk the open classification map.
for feature_name, cls in detail.classifications.items():
print(f" {feature_name}: {cls.values} ({cls.unit or 'n/a'}, {cls.group})")
print("exercised: product_categories.list / products.list / product.materials")
List Victorinox products within a product category, with pagination. Returns product identifiers, names, descriptions, SEO paths, subcategories, and image URLs. The seo_path returned for each product is consumed by get_product_materials to fetch material and classification details. Each page costs one upstream request.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-based). |
| limit | integer | Number of products per page. Clamped to 1–100. |
| category | string | Product category to list. Omitted defaults to SAK. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"limit": "integer, results per page",
"total": "integer, total number of products in the category",
"has_more": "boolean, whether more pages follow",
"products": "array of product objects, each with product_id, name, description, seo_path, product_url, category, subcategory, subcategory_code, image_url",
"total_pages": "integer, total pages available"
},
"sample": {
"data": {
"page": 1,
"limit": 5,
"total": 239,
"has_more": true,
"products": [
{
"name": "Evoke Wood Damast Limited Edition 2026",
"category": "SAK",
"seo_path": "/Products/Swiss-Army-Knife%E2%84%A2-and-Tools/Outdoor/Evoke-Wood-Damast-Limited-Edition-2026",
"image_url": "https://imageengine.victorinox.com/transform/c709ec4f-3045-4283-bda0-dc614d512bf3/SAK_0-9410-J26_S1",
"product_id": "0.9410.J26",
"description": "The Evoke Wood Damast Limited Edition 2026 combines modern precision with centuries-old forging mastery.",
"subcategory": "Outdoor",
"subcategory_code": "SAK_Outdoor"
}
],
"total_pages": 48
},
"status": "success"
}
}About the Victorinox API
Endpoints and Data Coverage
The API exposes three endpoints covering Victorinox product navigation and specification data. list_categories returns all top-level navigation categories, each with a code field directly usable as the category parameter in list_products. Each category entry also includes its subcategories array, giving you the full browse hierarchy in a single call.
list_products accepts category, page, and limit parameters (limit clamped to 1–100) and returns paginated product arrays. Each product object carries product_id, name, description, seo_path, product_url, category, subcategory, and subcategory_code. The total, total_pages, and has_more fields support pagination logic. The default category when category is omitted is SAK (Swiss Army Knives).
Product Material and Classification Detail
get_product_materials takes both a product_id and a seo_path — both obtained from list_products — and returns the classifications object: a map of feature names to {values, unit, group} entries covering material type, dimensions, color, functions count, and sales metadata. The materials field surfaces material strings directly (e.g., Beechwood, Polypropylene (PP)) without requiring you to traverse the full classifications map.
Data Shape Notes
Because get_product_materials requires both product_id and seo_path, a typical workflow calls list_products first to collect those fields, then calls get_product_materials per product. The seo_path values are URL-encoded path segments as returned by list_products and should be passed as-is to the detail endpoint.
The Victorinox API is a managed, monitored endpoint for victorinox.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when victorinox.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official victorinox.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a materials comparison tool for Victorinox knives using the
materialsarray fromget_product_materials - Catalog all Victorinox product subcategories programmatically using
list_categoriesand the returnedsubcategoriesarrays - Sync a product database with current Victorinox catalog names, descriptions, and image URLs from
list_products - Filter Victorinox products by category (e.g., Swiss Army Knives vs. cutlery) using the
categoryparameter inlist_products - Extract dimensional and color classification data from
classificationsfor product specification sheets - Identify products made from specific materials (e.g., beechwood handles) by querying
get_product_materialsacross paginated results
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Victorinox offer an official developer API?+
What does get_product_materials return beyond material names?+
classifications object, which maps feature names to {values, unit, group} entries. This can include size/dimension data, color, function count, and sales-related attributes depending on the product. The materials array is a convenience field that surfaces only the material values from within that classifications map.Does list_products return all Victorinox categories by default?+
category parameter is omitted, list_products defaults to the SAK (Swiss Army Knives) category. To list products from other categories, pass the code value returned by list_categories as the category parameter.