Developers
Replacement product API for agents and purchasing workflows.
Resolve printer model, HVAC filter, refrigerator water filter, shipping label supply, business consumable, and automotive consumable intent into ranked products, fit notes, and buying options.
Affiliate-supported mode
Use affiliate_supported when disclosed buying links are acceptable. This mode requires a Product Resolver API key and one credit per successful resolver call.
curl -H "Authorization: Bearer prk_..." "https://productresolver.com/resolve?intent=toner%20for%20Brother%20HL-L6200DW%20qty%204&mode=affiliate_supported"curl -H "Authorization: Bearer prk_..." "https://productresolver.com/resolve?intent=20x25x1%20MERV%2011%20air%20filter%20qty%2012&mode=affiliate_supported"curl -H "Authorization: Bearer prk_..." "https://productresolver.com/resolve?intent=4x6%20direct%20thermal%20shipping%20labels%20qty%2012&mode=affiliate_supported"curl -H "Authorization: Bearer prk_..." "https://productresolver.com/resolve?intent=3%201%2F8%20x%20230%20thermal%20receipt%20paper%20case%20qty%2050&mode=affiliate_supported"curl -H "Authorization: Bearer prk_..." "https://productresolver.com/resolve?intent=front%20wiper%20blades%20for%202018%20Toyota%20Camry%2026%2020%20set&mode=affiliate_supported"Neutral paid mode
Use neutral_paid when an agent or business needs non-affiliate output. Each successful call uses one prepaid credit.
curl -H "Authorization: Bearer prk_..." "https://productresolver.com/resolve?intent=toner%20for%20Brother%20HL-L6200DW&mode=neutral_paid"Free preflight
Use can-resolve when support is uncertain. It tells an agent whether a paid call is likely worth making, but withholds SKUs, compatibility families, and buying options.
curl "https://productresolver.com/can-resolve?intent=toner%20for%20Brother%20HL-L6200DW%20qty%204"Batch resolve
Use batch resolution for carts and recurring reorder lists. One request can carry up to 25 intents, and each successful item uses one Product Resolver credit.
curl -X POST -H "Authorization: Bearer prk_..." -H "Content-Type: application/json" -d '{"mode":"affiliate_supported","intents":["toner for Brother HL-L6200DW quantity 4","20x25x1 MERV 11 air filter quantity 12","front wiper blades for 2018 Toyota Camry 26 20 set"]}' "https://productresolver.com/resolve/batch"Agent wrappers
Use the wrapper registry when an agent builder needs the fastest integration path. It points to OpenAI tool schemas, MCP metadata, JSON-RPC tool calls, SDK clients, billing, and the paid-call policy.
POST /billing/checkout-sessionJavaScript wrapper
The hosted ESM client handles preflight, paid single resolve, paid batch resolve, direct MCP-style calls, and balance checks with the same one-credit-per-hit rule.
import { ProductResolverClient } from "https://productresolver.com/sdk/product-resolver.mjs";
const resolver = new ProductResolverClient({ apiKey: process.env.PRODUCT_RESOLVER_API_KEY });
const result = await resolver.mcpCall("resolve_product_intent", {
intent: "toner for Brother HL-L6200DW quantity 4",
mode: "neutral_paid"
});Credits
Prepaid API access
Stripe checkout is connected. Webhook fulfillment is connected. Stripe Checkout controls card, Link, and approved wallet methods from the Stripe Dashboard. Stablecoin and crypto checkout is enabled for eligible buyers. Agents can create a JSON checkout session at POST /billing/checkout-session. Direct wallet pay-per-call is not live yet.
curl -X POST -H "Content-Type: application/json" -d '{"pack_id":"starter_500","email":"[email protected]"}' "https://productresolver.com/billing/checkout-session"Agent manifest
Agent-readable purpose, policy, endpoint, and billing metadata.
Plugin manifest
Basic discovery manifest pointing to the public OpenAPI document.
Pricing JSON
Machine-readable paid affiliate-supported and neutral-paid access modes.
Agent catalog
Compact JSON catalog with categories, counts, preflight URLs, paid resolver URLs, and billing entry points.
Procurement packs
Scored recurring reorder templates that point agents toward paid batch resolver calls.
Wrapper registry
Integration index for OpenAI-style tools, MCP metadata, SDK clients, paid-call policy, and billing.
OpenAI tool schema
JSON-schema function tools for preflight, paid resolve, paid batch resolve, and balance checks.
Markdown catalog
Text-first supported catalog for agents that retrieve Markdown before choosing a paid call.
Credit pack feed
CSV product feed for the paid API credit packs that fund resolver calls.
Payment methods
Machine-readable Stripe Checkout, wallet, stablecoin, and planned direct payment status.
Shopping intents
Machine-readable replacement products with guide, click, and resolver URLs.
Preflight probe
Free support check that helps agents decide whether a paid resolve is worth calling.
Directory profile
Compact listing copy, example calls, monetization modes, and discovery URLs.
Agent procurement path
Paid neutral API workflow for agents that need non-affiliate output.