Product Catalog

The product catalog is where you discover what’s available to integrate. It’s structured in two layers: a top-level catalog file that lists all products, and per-product JSON files that contain the precise specifications for each one.

Your integration should read from both: the catalog to understand what exists, and the per-product file to get the exact requirements for whatever you’re building.

Catalog File

A single JSON file listing all products currently available for integration.

GEThttps://printkit.dev/products.json

Each entry in the catalog includes:

handle — URL-safe identifier used to fetch the per-product file
title — Display name of the product
product_description — Brief product description
product_page_url — Link to the product page on Social Print Studio’s website
type — Product type/category
product_photos — Product photography
order_submission_note — High-level notes about integration behavior

The catalog is the right starting point — use it to browse what’s available and select the product(s) that fit your application.

Variant Index

If you want the simplest possible SKU lookup flow, fetch the flat variant index first. It provides normalized fields like product_type, size, style, shape, frame_color, pages, and image_order_matters for easy filtering across the full catalog.

GEThttps://printkit.dev/variants.json

The variant index is best for:

Filtering all SKUs across the full catalog
Looking up normalized size, shape, style, or frame_color
Reading stable fields like exact_image_count and normalized_image_ratio

Tip

Start with variants.json when you know the kind of variant you want, then open the per-product JSON only if you need the richer product-specific notes.

Per-Product Files

Each product in the catalog has a dedicated JSON file. This is the source of truth for integration — always rely on the per-product file, not the catalog summary, when building your integration.

GEThttps://printkit.dev/products/{handle}.json

Per-product files define:

Variants — every available size and option, each with a unique variant_sku
Image count — exactly how many photos are required for a given variant
Aspect ratios — required crop ratios per variant (e.g. 1:1, 4:3, 2:3)
Submission constraints — any product-specific rules that affect how you build and submit the order

The handle in the catalog entry maps directly to the filename in this pattern.

Product Categories

Products generally fall into two practical buckets based on how images are submitted:

Single-image products

A single photo becomes a single printed item per selected variant. Submitting multiple photos results in multiple separate items added to the cart in one API call.

Examples: metal prints, wood prints, framed prints, large format prints.

Integration pattern: collect one or more photos and a variant choice, then submit. Each photo becomes its own cart line item.

Multi-image / set-based products

The customer selects a variant that implies a set size, and you collect exactly that many photos. Some products use photo order for sequencing (e.g. photo books); others don’t.

Examples: photo magazines, magnet sets, photo books.

Integration pattern: collect exactly N images (where N is defined in the variant), then submit as a single product. Photo order may matter — check the per-product file.

Note

The catalog will tell you the general behavior for a product, but the per-product JSON defines the exact image count and ordering rules for each variant.

Using the Catalog in Your Integration

A typical integration reads the catalog data once (at build time or on app load) and then uses variants.json for fast filtering and products/{handle}.json for the richer product notes that shape your UI.

# Step 1: Fetch the catalog
curl -s https://printkit.dev/products.json | jq '.products | keys'

# Step 2: Fetch the normalized variant index
curl -s https://printkit.dev/variants.json | jq '.variants[] | select(.product_handle == "metal-prints" and .size == "8x10")'

# Step 3: Fetch per-product details
curl -s https://printkit.dev/products/metal-prints.json | jq '.print_specific_details'

// Step 1: Fetch the catalog
const catalog = await fetch('https://printkit.dev/products.json').then(r => r.json());

// Step 2: Fetch the normalized variant index
const index = await fetch('https://printkit.dev/variants.json').then(r => r.json());

// Step 3: Find an 8x10 metal print
const variant = index.variants.find((entry) =>
  entry.product_handle === 'metal-prints' &&
  entry.size === '8x10'
);

// Step 4: Open the per-product file for richer notes if needed
const product = catalog.products['metal-prints'];
const spec = await fetch(product.detail_url).then(r => r.json());

// Step 5: Use the normalized SKU in your order submission
console.log(variant.sku); // "metal-print-8x10"
console.log(spec.print_specific_details);

import httpx

# Step 1: Fetch the catalog
catalog = httpx.get("https://printkit.dev/products.json").json()

# Step 2: Fetch the normalized variant index
index = httpx.get("https://printkit.dev/variants.json").json()

# Step 3: Find an 8x10 metal print
variant = next(
    v for v in index["variants"]
    if v["product_handle"] == "metal-prints" and v["size"] == "8x10"
)

# Step 4: Open the per-product file for richer notes if needed
product = catalog["products"]["metal-prints"]
spec = httpx.get(product["detail_url"]).json()

# Step 5: Use the normalized SKU in your order submission
print(variant["sku"])  # "metal-print-8x10"
print(spec["print_specific_details"])

Once you have the SKU for the variant you want to offer, you’re ready to submit orders. See the Order Handoff API for how to do that.

Tip

Keep the catalog and per-product files cached in your repo or build process. They don’t change often, and including them at build time avoids runtime fetch latency.

Browse Products

Here are the products currently available for integration. Each card shows the key details you need — use the product JSON link for full variant specifications and exact requirements.

Products15

Schemav1.0

Updated2026-03-09

Large Format Prints

Prints$9–60

Large format photo print enlargements, available in 20 sizes with optional white borders. Printed using a silver halide chemical process in a professional photo lab on premium Kodak photo paper. A great option for photo enlargements or posters that can be pinned up or framed by the customer. Cost effective, traditional, and flexible.

Product groupSingle image print

Order submissionSubmit one or more images. Each image is printed as a separate print at the selected size. Image ratio must match the selected variant size.

Available sizes (20)

8x88x108x1210x1010x3011x1412x1212x1812x3616x1616x2016x2420x2020x3020x4024x2424x3630x3030x4030x45

API Handlelarge-format-prints

Product Catalog

Catalog File

Variant Index

Per-Product Files

Product Categories

Single-image products

Multi-image / set-based products

Using the Catalog in Your Integration

Browse Products

Large Format Prints

Gallery Frames

Wood Prints

Acrylic Photo Block

Metal Prints

Photo Magazine

Greeting Cards

Photo Magnets

Postcards

Photo Stickers

Flat Cards

Hardcover Photo Book

Softcover Photo Book

Print Packs

Mini Prints