Unused product sold as new under the merchant's policy.
SELLER FEED SPECIFICATION
Send inventory once. Keep every offer verifiable.
ITEMPRISM accepts structured catalogs from approved merchants and partners. This specification keeps product identity, condition, total price, protection, and freshness comparable across sources.
01
Required fields
An offer cannot be published until a shopper can identify it, understand its condition, calculate a known total, and verify it on the merchant site.
external_idA stable identifier unique within your catalog.
titleThe exact product title, without promotional keyword stuffing.
conditionnew, open_box, refurbished, used, or as_is.
priceCurrent item price as a non-negative number.
currencyThree-letter ISO currency code, normally USD.
availabilityin_stock, limited, out_of_stock, or unknown.
product_urlThe canonical HTTPS landing page where the offer can be verified.
checked_atThe UTC time when price and availability were last verified.
02
Recommended fields
These fields improve exact matching, image search, warranty and return comparison, category placement, and duplicate control.
descriptionbrandmodelgtinmpncategorycondition_notesshippingstock_countimage_urlaffiliate_urlwarrantyreturns03
Condition requirements
Keep your original grade in condition_notes, while mapping every offer to one normalized comparison group.
Opened, returned, displayed, or repackaged inventory.
Inspected, restored, repaired, reset, or tested before resale.
Previously used inventory without a defined restoration process.
Parts, repair, untested, damaged, or explicitly sold without normal assurances.
04
Freshness and removal rules
Price comparison fails when stale offers remain visible. Every catalog needs a dependable update and removal process.
Send a complete snapshot or a clearly identified delta feed.
Use the same external_id for every update to an offer.
Mark unavailable offers out_of_stock; do not leave an old price active.
Refresh fast-changing inventory at least as frequently as your approved integration agreement requires.
Keep product and affiliate URLs on domains approved for the merchant.
05
Validation before publication
ITEMPRISM validates structure, normalizes conditions, checks destination hosts, groups equivalent products, and audits missing identifiers, images, protection terms, and stale source data.
GTIN, MPN, brand, model, title, and aliases are evaluated before offers are grouped.
Known total begins with item price plus mandatory shipping before tax.
Warranty and return text stays visible instead of being hidden in a score.
Outbound URLs are redirected only to merchant hosts approved in the private allowlist.
READY TO CONNECT A CATALOG?
Submit seller details Start with a controlled sample.
Send the feed format, approximate catalog size, categories, condition mix, and update frequency. ITEMPRISM will review a small sample before any offer becomes public.