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.

JavaScript 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.