Equivalent API

Different product. Same amount. Quantity-adjusted.

The Prodx Equivalent API calculates quantity multipliers between products so substitutions and comparisons are fair. If product A is 27oz and product B is 24oz, the API returns a multiplier of 1.12, telling you the shopper needs 1.12 of product B to match what they ordered. Simple math, but critical for trust.

See It In Action

View Documentation

Why Quantity-Blind Comparison
Creates Bad Swaps

When a shopper's original item is unavailable, most systems compare product labels, not actual quantity equivalence.

Unfair Replacements

A smaller fallback is not truly equivalent.

Confusing Comparison

Shoppers cannot tell how much more or less product they are getting.

Reduced Trust

Bad swaps create complaints and lower substitution acceptance.

How Prodx Makes Equivalence Explicit

Prodx returns a multiplier for each comparison product, showing exactly how much of the alternate item is needed to match the original quantity.

Pass a source product ID and a comparison set of product IDs.
Return quantity multipliers for each comparison product.
Use 1.0 to indicate equal quantity; values above or below that indicate the adjustment needed.
Pair the output with Substitutes for quantity-adjusted alternatives.
Support fairer substitution and comparison experiences.

Measurable Impact

Quantity-adjusted substitutions and comparisons build shopper trust. When shoppers can see they’re getting an equivalent amount, substitution acceptance rates improve and complaints about unfair swaps decrease.

Higher

Substitution acceptance

Transparent equivalence improves trust.

Fewer

Complaints about unfair swaps

Shoppers can see the math behind the match.

Better

Comparison clarity

Retailers present value and quantity side by side.

How a Top-10 Grocer Transformed Their Search Experience

See how structured product data eliminated "no results" pages and drove a measurable lift in online conversion.

Read the Full Story

Technical Specifications

Every Prodx API is designed for real-world retail environments — high volume, low latency, and continuous data updates. From authentication to uptime guarantees, everything is engineered to integrate cleanly and scale with your business.

Response Format

JSON

Authentication

API key (provided at onboarding)

Rate Limits

Configured per retailer at contract level

Hosting

Prodx-managed cloud infrastructure

Latency

Sub-200ms typical response times

Availability

99.9% + uptime SLA

Data Refresh

Continuous. Product data updates propagate within minutes of catalog changes.

Integration

RESTful API. Standard HTTPS. No SDKs required.

Onboarding

Three weeks typical. Send us your product feed, we handle the rest.

Support

Dedicated account team. Direct engineering access for integration questions.

GET /v1/equivalent?catalogId=GEN_CATALOG &productId=960038380
&productIds=960050655,196050883,960469440
{
  "productId": "960038380",
  "equivalentProducts": {
    "196050883": { "productId": "196050883", "quantity": 1.12 },
    "960050655": { "productId": "960050655", "quantity": 1.32 },
    "960469440": { "productId": "960469440", "quantity": 1.12 }
  },
  "equivalentRequest": {
    "catalogId": "GEN_CATALOG",
    "productId": "960038380",
    "productIds": "960050655,196050883,960469440"
  }
}

Ready to see what the Equivalent API can do with your catalog?

Send us your product feed and we'll show you results in weeks.

Book a Demo

Explore All APIs

The data infrastructure everything runs on.

Product data infrastructure for America's leading grocery retailers.

hello@prodx.com

Built on Prodx

Company

Get Started

How It Works