PlatformMarketplacesPricingDashboardStart for free
Marketplace products

Get marketplace product

Gets a marketplace product by id.

GET
/v1/marketplace-products/{marketplaceProductId}

Returns the local content (desired), the last fact the marketplace confirmed (observed, read-only), the catalogReference, and publicationState. It does not include variations: use list variations. On Mercado Livre, the title the channel generated shows in observed.content.

Authorization

api_key
headerAuthorizationBearer <token>

API key (mk_...)

Path Parameters

marketplaceProductId*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Response Body

The requested marketplace product.

application/json
  1. response

Content one marketplace shares between offers. Listings point at it.

id*string

Marketplace product identifier.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
sellerId*string

Seller that owns this marketplace product.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
connectionId*string

Marketplace connection that owns this marketplace product.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
externalId*|

Marketplace identity of the shared content (Mercado Livre family_id, or the item id of a legacy item; Amazon parent ASIN). null until published or imported.

desired*

Persisted local content intent.

observed*|

Last observed marketplace content. null until first read.

catalogReference*|

Optional external catalog reference.

publicationState*string

Local publication work state of the content.

Value in"never_published""clean""dirty""pending""failed"
createdAt*string

When the marketplace product was created.

Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
Formatdate-time
updatedAt*string

When the marketplace product was last changed.

Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
Formatdate-time
curl -X GET "https://example.com/v1/marketplace-products/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "id": "8a6f0c55-6a1e-4c55-9b0a-3b1f2d9e4c10",  "sellerId": "3d1c8a52-7f0e-4b0a-8a65-9c1b2f6d7e01",  "connectionId": "3f7d8a57-3e44-4c91-bbf1-02d9f4e4e5b0",  "externalId": null,  "desired": {    "content": {      "title": "iPhone 16",      "brand": "Apple",      "condition": "new"    },    "variationAxes": [      "color",      "storage"    ]  },  "observed": null,  "catalogReference": null,  "publicationState": "never_published",  "createdAt": "2026-10-10T12:00:00.000Z",  "updatedAt": "2026-10-10T12:00:00.000Z"}

List marketplace products GET

Lists the account's marketplace content, paginated.

Update marketplace product content PATCH

Updates only the local content, with merge.