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.

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.

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.
The data infrastructure everything runs on.
Product data infrastructure for America's leading grocery retailers.
hello@prodx.com
© 2026 Prodx. All rights reserved.