Feed requirements
Request partner reviewPartner feed specification
ApplianceIQ ingests Google Merchant Center–format XML feeds today, plus an authenticated JSON push API for approved partners. CSV, SFTP, and affiliate network adapters are not yet supported.
Accepted formats
Google Merchant Center XML feed URL (now)
Authenticated JSON push API (now, by partner approval)
CSV, SFTP, and affiliate network feeds — not yet supported
Update cadence
Push API offers: as often as submitted
Feed URL offers: once daily (06:00 UTC cron)
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
- 1MPN or model number (primary match key)
- 2UPC/GTIN (planned — not yet matched)
- 3Title/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. Feed URL and push API integrations do not yet ingest image_link automatically — send media separately for manual review until automated image ingestion ships.
Common validation errors
Manual submissions and partner applications are reviewed for public-display blockers before they affect shopper-facing catalog or offer data. Automated feed-URL pulls write directly today; a staged review step for that path is planned.
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