ImageHub ZIP Structure

Every ImageHub delivery is packaged as one or more ZIP archives. Here is how the contents are organised so you can load them straight into your pipeline.

Folder Structure

furniture/
  wayfair/
    prod_abc123/
      primary.jpg
      angle_01.jpg
      lifestyle.jpg
      metadata.json

Top-level folders are the product category. Inside each category folder the next level is the source platform, and inside that each product has its own folder named by product ID.

Extracting

# Extract all ZIPs into a single output directory
unzip "*.zip" -d ./imagehub_images/

# Python — load all metadata files
import glob, json
records = [json.load(open(f)) for f in glob.glob("**/metadata.json", recursive=True)]

If your order is split across multiple ZIPs, extract them all into the same output directory — the folder structure is consistent across ZIPs so files will merge correctly.