Feed requirements

Partner feed specification

ApplianceIQ accepts structured CSV feeds now. JSON, API, SFTP, and affiliate network feed adapters can follow after source approval.

Request partner review

Accepted formats

CSV now
JSON/API later
SFTP and affiliate network feeds after approval

Update cadence

Offer feeds: hourly to daily where allowed
Catalog/spec feeds: daily to weekly
Manual CSV: reviewed before display

Timestamp expectations

last_checked
feed_updated_at
ISO date or datetime preferred

Required product fields

brand
model_number
product_name
category
subcategory where available

Recommended product fields

UPC/GTIN
MPN
width
height
depth
capacity
finish
fuel type
energy star
key specs
manufacturer URL
product page URL

Required offer fields

store_name
model_number or product identifier
product_price or sale_price
availability
listing_url
last_checked or feed_updated_at

Recommended offer fields

delivery window
condition
installation fee
haul-away fee
affiliate URL
region/postal coverage
return policy URL
financing info
open-box/clearance flag

Product identifier priority

  1. 1UPC/GTIN
  2. 2Brand + model number
  3. 3MPN
  4. 4Title/spec match requiring review

Image and media fields

image_url
source_type
permission_status
alt_text
media_owner
usage rights confirmation

Product images display publicly only when permission status is approved, partner_provided, or licensed.

Common validation errors

Partner files are reviewed for public-display blockers before they can affect shopper-facing catalog or offer data.

Missing required product or offer fields
Missing UPC/GTIN, brand + model number, or MPN
Offer missing price, availability, listing URL, or last checked timestamp
Image permission is needs_review, unknown, or missing
Duplicate normalized model candidate
Low-confidence product match requiring manual review