SHshopfront
Listings

Generate listings from multiple images (bulk)

Submit multiple product images for automatic grouping and parallel listing generation. The AI identifies product boundaries, groups images by product, then generates a complete listing for each product in parallel.

How it works:

  1. Submit image URLs (up to 50 images)
  2. AI groups images into products
  3. Each product is sent through listing generation
  4. Poll GET /v1/jobs/{jobId} for results

For larger batches (up to 1000 images), use the presigned S3 upload flow via POST /v1/listings/bulk/presign followed by POST /v1/listings/bulk.

post/v1/listings/bulk

Request

  • Base URL
    https://api.shopfront.app
  • Auth
    HTTP bearer

Request body

batchIdstring uuid required

Client-generated UUID for batch tracking

imageUrlsstring[]

Image URLs to process. The AI will group these into products automatically. Limited to 50 images — use POST /v1/listings/bulk/presign for larger batches.

imageS3Keysstring[]

S3 keys from presigned upload (for batches >50 images). Get keys from POST /v1/listings/bulk/presign.

channelsstring[] required

Marketplace channels to generate mappings for

aiNotesstring

Additional context for the AI

ebayMarketplace'EBAY_US' | 'EBAY_AU' | 'EBAY_GB' | 'EBAY_DE' | 'EBAY_CA' | 'EBAY_FR'
templateIdstring uuid

Template ID for generating marketplace-specific content. Falls back to the organisation's default template if not provided.

enableBackgroundRemovalboolean

Remove background from each product's hero image

enableImageEnhancementboolean

Apply AI image enhancement to each product's hero image

Response

Batch accepted — grouping and generation started

Changes

No recorded changes to this operation across all 1 revision of this API.