PrintfulカタログAPI

Printfulには空白の商品とバリエーションの充実したカタログがあります。Product(商品)は商品の特定のタイプ、モデル、生産者を表します。一方Variant (バリエーション)はTシャツの正確なサイズや色やポスターの寸法といった商品のより詳細な属性を指定します。Printfulカタログの各アイテムに唯一の「バリエーションID」があります。商品同期または注文管理の際、各商品のバリエーションIDを指定する必要があります。下記のAPIバリエーションID一覧をご利用ください。

商品や注文を作成する際に、必ずバリエーションIDを参照することが非常に重要です。商品IDとバリエーションIDは同じ物ではありません。バリエーションIDの代わりに商品IDを使用してしまうと、異なる商品が作成されたり、注文されたりする可能性があります。商品IDは、Printfulの商品をより簡単に閲覧できるためのものです。

このAPIで商品に使えるデザインデータの種類や、各デザインデータにかかる追加料金(Tシャツのバックプリントや内側のラベル印刷など)を調べることもできます。 さらに、商品タイプの中には追加オプション(例:刺繍タイプと糸色)が可能なものがある場合、そのオプションもレスポンスに表示されます。

Get all Product list

GET https://api.printful.com/products

Returns list of Products available in the Printful.
Input parameters:
無し
レスポンス形式:
code integer ステータスコードのレスポンス 200
result Product [ ]
id integer Product ID
type string Product type identifier
type_name string Product type name
brand string Brand name
model string Model name
image string URL of a sample image for this product
variant_count integer Number of available variants for this product
currency string Currency in which prices are returned
files FileType [ ] Definitions of Print/Mockup file categories that can be attached to this product
id string Deprecated file type identifier. Please use type field instead!
type string File type identifier - use this to specify a file's purpose when creating an order
title string Display name
additional_price string Additional price when this print file type is used
options OptionType [ ] Definitions of additional options that are available for this product
id string Option identifier - use this to specify the option when creating an order
title string Display name
type string Data type of this option (currently only 'bool' is supported)
values array Option values - [key, value] map
additional_price string Additional price when this option is used
additional_price_breakdown array Additional price breakdown by type - [key, value] map
is_discontinued boolean If product is disabled in push
avg_fulfillment_time float Average number of days for order to be fulfilled
description string Product description
APIキー
Execute

Get information about Variant

GET https://api.printful.com/products/variant/{id}

Returns information about a specific Variant and its Product
Input parameters:
id integer Variant ID
レスポンス形式:
code integer ステータスコードのレスポンス 200
result VariantInfo
variant Variant Information about the selected Variant
id integer Variant ID, use this to specify the product when creating orders
product_id integer ID of the product that this variant belongs to
name string Display name
size string Item size
color string Item color
color_code string Hexadecimal RGB color code. May not exactly reflect the real-world color
color_code2 string Secondary hexadecimal RGB color code. May not exactly reflect the real-world color
image string URL of a preview image for this variant
price string Variant's price (can change depending on print files and optional settings)
in_stock boolean Stock availability of this variant
availability_regions array Map of [region code, region name] of regions where the variant is available for fulfillment
availability_status AvailabilityStatus [ ] Detailed stock status per region
region string Region code
status string Stock status. Possible values include: 'in_stock' - available for fulfillment, 'stocked_on_demand' - available for fulfillment, 'discontinued' - permanently unavailable, 'out_of_stock' - temporarily unavailable
product Product Information about the Product that the Variant belongs to
id integer Product ID
type string Product type identifier
type_name string Product type name
brand string Brand name
model string Model name
image string URL of a sample image for this product
variant_count integer Number of available variants for this product
currency string Currency in which prices are returned
files FileType [ ] Definitions of Print/Mockup file categories that can be attached to this product
id string Deprecated file type identifier. Please use type field instead!
type string File type identifier - use this to specify a file's purpose when creating an order
title string Display name
additional_price string Additional price when this print file type is used
options OptionType [ ] Definitions of additional options that are available for this product
id string Option identifier - use this to specify the option when creating an order
title string Display name
type string Data type of this option (currently only 'bool' is supported)
values array Option values - [key, value] map
additional_price string Additional price when this option is used
additional_price_breakdown array Additional price breakdown by type - [key, value] map
is_discontinued boolean If product is disabled in push
avg_fulfillment_time float Average number of days for order to be fulfilled
description string Product description
APIキー
id Variant ID
Execute

Get Product's Variant list

GET https://api.printful.com/products/{id}

Returns information about a specific product and a list of variants for this product.
Input parameters:
id integer Product ID
レスポンス形式:
code integer ステータスコードのレスポンス 200
result ProductInfo
product Product Information about the selected product
id integer Product ID
type string Product type identifier
type_name string Product type name
brand string Brand name
model string Model name
image string URL of a sample image for this product
variant_count integer Number of available variants for this product
currency string Currency in which prices are returned
files FileType [ ] Definitions of Print/Mockup file categories that can be attached to this product
id string Deprecated file type identifier. Please use type field instead!
type string File type identifier - use this to specify a file's purpose when creating an order
title string Display name
additional_price string Additional price when this print file type is used
options OptionType [ ] Definitions of additional options that are available for this product
id string Option identifier - use this to specify the option when creating an order
title string Display name
type string Data type of this option (currently only 'bool' is supported)
values array Option values - [key, value] map
additional_price string Additional price when this option is used
additional_price_breakdown array Additional price breakdown by type - [key, value] map
is_discontinued boolean If product is disabled in push
avg_fulfillment_time float Average number of days for order to be fulfilled
description string Product description
variants Variant [ ] Array of Variants available for the selected product
id integer Variant ID, use this to specify the product when creating orders
product_id integer ID of the product that this variant belongs to
name string Display name
size string Item size
color string Item color
color_code string Hexadecimal RGB color code. May not exactly reflect the real-world color
color_code2 string Secondary hexadecimal RGB color code. May not exactly reflect the real-world color
image string URL of a preview image for this variant
price string Variant's price (can change depending on print files and optional settings)
in_stock boolean Stock availability of this variant
availability_regions array Map of [region code, region name] of regions where the variant is available for fulfillment
availability_status AvailabilityStatus [ ] Detailed stock status per region
region string Region code
status string Stock status. Possible values include: 'in_stock' - available for fulfillment, 'stocked_on_demand' - available for fulfillment, 'discontinued' - permanently unavailable, 'out_of_stock' - temporarily unavailable
APIキー
id Product ID
Execute

Printfulを試す準備はできましたか?