Affinities API

Products that share shoppers. Not just shelf space.

The Prodx Affinities API identifies products that share purchasing patterns at two levels. Advanced affinities capture deep behavioral correlations. Basic affinities capture broader category-level patterns. Both are built from real transaction data, not metadata guesses.
Affinities API

Why 'Similar Products'
Is Usually Too Shallow

Category-based similarity misses the products that real shoppers tend to buy around the same habits and preferences.

Category Bias

Showing every granola for a granola view is not the same as behavioral relevance.

No Behavioral Depth

Most similarity tools ignore the shared-shopper signal.

Missed Discovery

Retailers lose the chance to surface products category trees would never reveal.

How Prodx Surfaces Shared-Shopper Relationships

Prodx returns both advanced and basic affinity groups, giving retailers deeper behavioral correlation alongside broader pattern recognition.
  • Pass a product ID to retrieve affinity groups.
  • Return Advanced and Basic affinity sets with ranked products and scores.
  • Use real transaction data rather than simple metadata similarity.
  • Support PDP modules, discovery surfaces, and merchandising insights.
  • Create behavior-based relevance that complements browse and search.
Affinities API

Measurable Impact

When product data is clean, every metric improves.

Deeper

Behavioral relevance
Affinities reflect how people actually shop.

Better

Discovery quality
Retailers surface connections category trees miss.

More Useful

Product modules
Shared-shopper logic creates stronger recommendation stories.
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/affinities?catalogId=GEN_CATALOG &productId=960038380
{
  "affinitiesGroups": [
    {
      "id": "AFFINITIES_ADVANCED_RETAILER",
      "name": "Affinities Advanced Retailer",
      "affinitiesProducts": [
        { "productId": "960050655", "score": 94 },
        { "productId": "196050883", "score": 87 }
      ]
    },
    {
      "id": "AFFINITIES_BASIC_RETAILER",
      "name": "Affinities Basic Retailer",
      "affinitiesProducts": [
        { "productId": "960469440", "score": 82 },
        { "productId": "960038416", "score": 76 }
      ]
    }
  ],
  "affinitiesRequest": {
    "catalogId": "GEN_CATALOG",
    "productId": "960038380"
  }
}

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

Send us your product feed and we'll show you results in weeks.
© 2026 Prodx. All rights reserved.