Universal Gift Registry: Add Any Product Link From Any Store

A universal gift registry lets people add a product from any store by pasting its link. This guide covers what link matching takes to build yourself, how Affiliate.com handles it, and a demo that runs the real lookups.

Affiliate.com Universal Gift Registry: Add Any Product Link From Any Store graphic

A universal gift registry lets people add a gift from any store by pasting its link. Most registries cannot do that, because a link names one page at one store and a registry needs to know which product it is, where else it is sold and what it costs. Affiliate.com handles that part. It turns a link into a barcode, then returns every store that sells the barcode with its price and stock. This guide covers what link matching takes to build yourself, how the lookups work, and how a registry uses them. The demo below runs them on real products, with lookups last pulled November 17, 2026.

What makes a registry universal

A single-store registry is simple because the store knows its own products. Every item has the store’s ID, the store holds the price and stock, and a guest has one place to go. A universal registry has none of that. Items arrive as links from different stores, each with its own address format, its own tracking text and its own product ID.

What a registry needs to knowSingle-store registryUniversal registry
Which product is this?The store’s own ID.A barcode, which means the same thing in every store.
Where can a guest buy it?At that store.At every store that sells the barcode.
Is it on the list already?Compare store IDs.Compare barcodes, whichever link it came from.
What does it cost?The store’s price.Each store’s price, lowest in stock first.

What it takes to build link matching yourself

Accepting any link means solving several problems at once, and each one needs ongoing work.

What a universal registry has to doWhat it takes to build yourself
Recognize the product behind a linkEvery store formats its addresses differently, and many add tracking text that changes. You need rules or a lookup for each store, kept up to date as stores change their pages.
Treat two links to the same product as one itemA way to match products across stores, or the same gift is added twice.
Find where else the product is soldA connection to each retailer, and a way to tell which of them carry the item.
Show a price and stock for each storeCurrent data from every store, refreshed often enough to trust.
Handle a link that does not matchPages with several colors or sizes, stores you do not cover and links that have gone stale.

Each of these is manageable alone. Together, across many retailers and for registries that stay open for months, they are a data pipeline and not a registry feature.

How Affiliate.com handles it

Affiliate.com does the matching and the tracking. A registry makes up to three lookups, and only the first touches a link.

LookupRequestWhat the registry gets
Link to barcodePOST /v1/tools/convert/url-to-barcodeA list of barcodes for each link. One means a match, none means no match and several means the page covers more than one product.
Barcode to every storePOST /v1/products/price-historyEach store that sells the barcode, with its price, stock and recent range, and a link to its page.
Barcode to store SKUPOST /v1/tools/convert/barcode-to-skuThe store’s own identifier for the product, useful for matching an order from that store.

The second lookup is what makes the registry universal, because it shows guests every store and not only the one the link came from. The third is optional. Our guide to barcode lookup covers all three in more detail, and barcode search covers the identifiers.

Add any store link to a registry

Pick a product page someone might paste, then step through the three lookups. Each step shows the real request and the real response, and the last step shows the one item the registry would save. The page holds a rotating set of products rebuilt every night, and it offers three of them, a different three on most visits.

Notice how little the registry keeps at the end: a barcode. The product name, stores and prices are fetched when the list is shown. That is why a second link to the same product is harmless. It produces the same barcode, so the registry sees the same item.

When a link does not convert

Some links will not convert, and a registry has to expect that. A link to a store that is not in the catalog returns an empty list. A page that sells a product in several colors or sizes can return several barcodes. Four responses cover the cases.

What comes backWhat the registry does
One barcodeSave the item.
Several barcodesAsk which color, size or version the person meant, and save that one.
An empty listOffer a name search instead, so the person can find the product and pick it from the results.
An errorKeep the link, tell the person it could not be checked yet and try again later.

In a test of 98 product links from 45 stores on November 17, 2026, a link sent exactly as the store lists it converted to the product’s own barcode 74 times. Adding tracking text made no difference (77). Removing the query string made it worse (68), because a query string can choose the color or size. Changing the letter case of the path broke most matches (52). So send the link as it was pasted, and keep in mind that about one in four of these links did not return the product’s own barcode, so every flow needs a fallback.

Recognizing duplicates

A couple adds a pan from one store, a family member adds the same pan from another, and a guest buys both. With barcodes the check is simple: before saving an item, look for its barcode on the list. If it is there, add to the quantity or tell the person it is already wanted. This is the strongest reason to convert on the way in. A registry that stores links has to compare pages, and pages from different stores do not look alike.

What to store, and what to fetch

Store in your databaseFetch when the registry is shown
The barcodeThe product name, brand and picture
The quantity wanted and any noteEvery store that sells it
The pasted link, if you want to show itEach store’s price, stock and recent range
Whether a guest has marked it as boughtThe store SKU, when you need to match an order

Keeping the original link is optional, and nothing should depend on it. See our Gift Registry API guide for building the list around the barcode, the Wedding Registry API guide for choosing a store when the first one runs out, and the Baby Registry API guide for checking stock.

What the November 17, 2026 pull shows

The three lookups ran on real products on November 17, 2026. We chose products whose links convert, so these results show what a registry can do with a link that matches, not how often links match. Every link in the table converted to the product’s barcode, and three of the five linked stores were more expensive than the cheapest store that had the product in stock. Three of the five had a store SKU on file for the linked store. None returned more than one barcode for the link.

ProductLinked storeIts priceCheapest in stockBarcodes returnedStore SKU
Mikasa French Countryside dinnerwarekohls.com$66.99$51.97161858049
Lodge black cast iron skilletdickssportinggoods.com$12.99$12.901None on file
Shark Freestyle Max cordless vacuumchewy.com$149.99$149.9912073734
Cuisinart Mini-Prep Plus food processormacys.com$64.95$51.961None on file
Graco Pack ’n Play Simple Solutions playardwayfair.com$119.99$119.991HBXL1287

This table is fixed to November 17, 2026. The demo above is rebuilt every night with a different set of products, so its figures will change. Treat the table as a record of one day. A handful of products is a small sample and not a measure of any market or of how often links match.

Terms

TermWhat it means here
Universal registryA registry that accepts products from any store, not only from one store’s catalog.
BarcodeA product’s UPC, EAN or GTIN. It identifies the product itself, whichever store sells it.
Store SKUA store’s own identifier for a product. It means something only at that store.
DeduplicationRecognizing that two items are the same product, here by comparing barcodes.

Getting started in three steps

StepWhat to do
1. Get a keyRequest an API key from Affiliate.com. REST requests send it as a Bearer token in the Authorization header, and an MCP client uses the same key.
2. Convert on the way inWhen someone pastes a link, send it to the URL to barcode lookup and handle the four responses above. Save the barcode, not the link.
3. Fetch when you show itMake one price history request per item to list every store, and show the lowest in-stock price first. How often to refresh covers the schedule.
One API call
Registries that accept any link
  • ✓Turn a store link into a barcode
  • ✓Find every store that sells it
  • ✓The same lookups as MCP tools or REST requests
Get API access →
Request
{
  "data": [
    "https://www.example-store.com/product/12345"
  ]
}