Skip to content

Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. 🔥

feat(api): document the product variant gtin, mpn and condition fields (#5556)

Evan McCarthyd297ae5f9d84
diff --git a/apps/api/openapi.json b/apps/api/openapi.json
index f387b8539..f70a26de1 100644
--- a/apps/api/openapi.json
+++ b/apps/api/openapi.json
@@ -10101,6 +10101,19 @@
"type": "string",
"description": "The variant SKU."
},
+ "gtin": {
+ "type": "string",
+ "description": "The variant's GTIN (EAN, UPC or ISBN), digits only, with a valid check digit. Present only when the page or store states one."
+ },
+ "mpn": {
+ "type": "string",
+ "description": "The variant's manufacturer part number. Present only when the page states one."
+ },
+ "condition": {
+ "type": "string",
+ "enum": ["new", "used", "refurbished", "damaged"],
+ "description": "The variant's item condition. Present only when the page states one; never assumed to be new."
+ },
"title": {
"type": "string",
"description": "The variant title."
diff --git a/apps/api/src/types/product.ts b/apps/api/src/types/product.ts
index 9ec23b6ce..4439f13d8 100644
--- a/apps/api/src/types/product.ts
+++ b/apps/api/src/types/product.ts
@@ -23,6 +23,9 @@ const productImageSchema = z.object({
const productVariantSchema = z.object({
id: z.string().optional(),
sku: z.string().optional(),
+ gtin: z.string().optional(),
+ mpn: z.string().optional(),
+ condition: z.enum(["new", "used", "refurbished", "damaged"]).optional(),
title: z.string().optional(),
values: z.record(z.string(), z.unknown()).optional(),
price: productPriceSchema.optional(),
diff --git a/apps/js-sdk/firecrawl/src/v2/types.ts b/apps/js-sdk/firecrawl/src/v2/types.ts
index 9ad1e9a74..b9ccee9d5 100644
--- a/apps/js-sdk/firecrawl/src/v2/types.ts
+++ b/apps/js-sdk/firecrawl/src/v2/types.ts
@@ -577,6 +577,9 @@ export interface ProductSale {
export interface ProductVariant {
id?: string;
sku?: string;
+ gtin?: string;
+ mpn?: string;
+ condition?: "new" | "used" | "refurbished" | "damaged";
title?: string;
values?: Record<string, unknown>;
price?: ProductPrice;
diff --git a/apps/python-sdk/firecrawl/v2/types.py b/apps/python-sdk/firecrawl/v2/types.py
index 33cb7d1fd..1c912b8bf 100644
--- a/apps/python-sdk/firecrawl/v2/types.py
+++ b/apps/python-sdk/firecrawl/v2/types.py
@@ -329,6 +329,9 @@ class ProductVariant(BaseModel):
id: Optional[str] = None
sku: Optional[str] = None
+ gtin: Optional[str] = None
+ mpn: Optional[str] = None
+ condition: Optional[Literal["new", "used", "refurbished", "damaged"]] = None
title: Optional[str] = None
values: Optional[Dict[str, Any]] = None
price: Optional[ProductPrice] = None