Models
Questa pagina è disponibile solo in inglese.
The Listing object
Every field of the Listing object, with types, required flags and validation rules.
The Listing object
| Field | Type | Description |
|---|---|---|
id | string | Opaque: unique per product and channel account (two Shopify accounts give the same product two different listing ids). Never build or parse it. e.g. list_9ac2e |
object | string | always listing |
product_id | string | |
channel_account_id | string | |
channel | string | Base channel of the account (denormalized for convenience) |
status | ListingStatus | New values may be added; tolerate unknowns. One of: listed, imported, ongoing, error, delisted |
id_on_channel | string · nullable | |
url_on_channel | string · nullable | uri |
site | string · nullable | eBay only. The marketplace site this listing lives on (e.g. US, Italy). Stamped at publish |
overrides | object | This channel's own texts; null = the product's (title, description). Imported listings start with the channel's texts |
overrides.title | string · nullable | |
overrides.description | string · nullable | |
overrides.category_id | string · nullable | Not available yet |
content | object | What the channel receives. The override where set, the product's text otherwise |
content.title | string · nullable | |
content.description | string · nullable | |
attributes | object | Channel/category attributes (eBay item aspects, Etsy properties…). Not writable through the API yet: a write with attributes is refused with 422 validation_failed |
variants | array of ListingVariant | |
issues | array of Issue | |
operation_id | string · nullable | The last API operation with a result on this listing (publish, resync, delist, stock or price push, product edit), in progress or settled: it keeps pointing at it after it completes. Read its outcome and per-channel error with GET /operations/{id}. null when the API never wrote to this listing (e.g. a listing created from the dashboard) |
created_at | string | When the listing was created (first publish or import on this account). ISO 8601 |
updated_at | string | Last change of the listing. ISO 8601 |
Request models
What you send when creating or updating. Fields not listed are ignored.
ListingCreate
| Field | Type | Required | Description |
|---|---|---|---|
product_id | string | required | |
channel_account_id | string | required | |
site | string | optional | eBay only. Target marketplace site for NEW listings; defaults to the account's configured site |
overrides | object | optional | Not available yet. Sending a non-empty object returns 422. Arrives in a later release |
overrides.title | string | optional | |
overrides.description | string | optional | |
overrides.category_id | string | optional | |
attributes | object | optional | Not available yet. A write with attributes is refused with 422 validation_failed |
ListingUpdate
| Field | Type | Required | Description |
|---|---|---|---|
overrides | object | optional | |
overrides.title | string · nullable | optional | This channel's own title; null = the product's. Max 1000 chars |
overrides.description | string · nullable | optional | This channel's own description (HTML); null = the product's. Max 100000 chars |
overrides.category_id | string · nullable | optional | Not available yet (422) |
attributes | object | optional | Not available yet (422) |
Ultimo aggiornamento il 18 ottobre 2026