Minted
Minted's real photo-card catalog and live pricing engine — browse real designs in a category and price an exact personalized configuration (paper, print…
Minted's real photo-card catalog and live pricing engine — browse real designs in a category and price an exact personalized configuration (paper, print method, foil, quantity) against Minted's own pricing engine rather than a researched estimate.
Domain: minted.com
Also known as: Minted, minted, Minted.com, minted.com
Call it directly
bowmark.providers.minted.searchCards(category: string): Promise<MintedCardDesign[]>
bowmark.providers.minted.priceCard(groupSlug: string, sku: string, styleSlug: string, selections?: MintedCardSelections): Promise<MintedCardPrice>Functions
| Function | What it does |
|---|---|
searchCards | Browses one of Minted's real photo-card/stationery categories (e.g. "holiday-photo-cards", "birth-announcements") and returns the real designs on it — sku, title, artist, dimension, and the… |
priceCard | Prices ONE exact card configuration against Minted's own live pricing engine and returns the real computed total, the full quantity-tier table, and a personalizeUrl to finish on-site.… |
Types
// Minted's OWN shapes — not a capability contract.
interface MintedCardDesign {
sku: string;
styleSlug: string; // the product URL's third path segment
artistName: string;
groupSlug: string; // the product URL's second path segment
dimension: string;
colorways: { id: string; name: string }[];
url: string;
}
interface MintedQuantityPrice { quantity: number; price: number } // price in dollars
interface MintedOptionRange { low: number; high: number } // dollars
interface MintedCardSelections {
color?: string; paper?: string; format?: string; printMethod?: string;
quantity?: number; customFoil?: boolean; greeting?: string;
}
interface MintedCardPrice {
sku: string;
groupSlug: string;
styleSlug: string;
selected: Required<MintedCardSelections>; // the exact config Minted priced
totalPrice: number; // real total for selected.quantity
quantityTable: MintedQuantityPrice[]; // real price at every quantity tier
optionRanges: Record<string, MintedOptionRange>;
personalizeUrl: string; // finish on-site from here
}Examples
// What would 100 personalized New Year photo cards actually cost, on Pearlescent paper?
const designs = await bowmark.providers.minted.searchCards("holiday-photo-cards");
const design = designs.find((d) => d.title === "Preppy Seaside");
const priced = await bowmark.providers.minted.priceCard(design.groupSlug, design.sku, design.styleSlug, {
paper: "Pearlescent",
quantity: 100,
});
return { total: priced.totalPrice, finishOnSite: priced.personalizeUrl };// What quantity tiers and price swing does one design's paper choice carry?
const priced = await bowmark.providers.minted.priceCard("new-year-photo-cards", "MIN-FYJ-HNY", "preppy-seaside");
return { quantityTable: priced.quantityTable, paperRange: priced.optionRanges.paper };