Marketplace Partner Item API

requests

The method and fields for each product in an array of products.

data

The information about the product to be created, updated, or deleted.

title

String (Character limit: 200)

Required

The title of the product item that appears on the Marketplace listing.

This text will appear on Marketplace. Do not include HTML tags.

condition

Enum {new, refurbished, used, used_like_new, used_good, used_fair, cpo, open_box_new}

Required

The condition of the product item.

partner_product_condition

Enum {acceptable, brand_new, certified_pre_owned, certified_refurbished, damaged, digital_good, excellent_refurbished, for_parts_or_not_working, good, good_refurbished, graded, like_new, new, new_other, new_other_see_details, new_with_box, new_with_defects, new_with_tags, open_box, others, pre_owned, remanufactured, retread, seller_refurbished, ungraded, used, very_good, very_good_refurbished, new_open_box, open_box_used, new_factory_sealed, unknown}

Optional

Product conditions. Optional field that will override the condition field. Use if more specificity is desired for the condition of the product.

price

String (Character limit: 9999)

Required

Format the price as a number, followed by a space and then the 3-letter ISO 4217 currency code. Ex. 10.99 EUR

If the listing type is ‘auction’ this is the bid price of the product. Format the price as a number, followed by a space and then the 3-letter ISO 4217 currency code.

link

String

Required

Mobile URL web link to the product detail page.

partner_product_html_desc_uri

String

Optional

URL link to site with full description of product. Used if product description contains more than can fit in the text field ‘description’. Marketplace will optionally provide a link to the full description.

partner_seller_id

String (Max character limit: 100)

Required

Unique identifier for the seller. Needs to match partner_seller_id in the seller information.

Example: “partner_seller_id”: “great_seller_inc”

fb_product_category

String

Optional

Facebook product category for the item. Most specific Facebook product category possible from this list: Spreadsheet (.csv) or Plain text (.txt).

sale_price

String

Optional

Format the price as a number, followed by a space and then the 3-letter ISO 4217 currency code. Ex. 10.99 EUR. This is the same format as the price field. Use in conjunction with the price field to show discounts.

additional_image_link

String (Character limit: 2000)

Optional

URLs for up to 20 additional images of your item, separated by a comma (,), semicolon (;), space ( ) or vertical bar (|). Follow the same image specifications as image_link.

partner_attribute_data

Nullable json object { “color”: “blue” }

Available keys: aspect_ratio, band_material, bike_type, brand, break_type, cable_length, capacity, case_size, certification, character, circulated_uncirculated, closure, color, compatible_bike_type, compatible_brand, compatible_model, compatible_operating_system, compatible_product, connectivity, credit_included, denomination, department, display_technology, dress_length, exterior_color, exterior_material, fabric_type, features, film_format, fit, focal_length, focus_type, form_factor, format, frame_color, game_name, game, gauge, golf_club_type, handedness, inseam, internet_connectivity, item_height, item_length, item_weight, item_width, items_included, main_stone, manufacturer_part_number, manufacturer, material, maximum_aperture, maximum_magnification, maximum_resolution, memory_cards_supported, metal_purity, metal, model, mount, mpn, network, number_of_items, occasion, outer_shell_material, package_quantity, part_type, pattern, performance_activity, platform, processor, publication_name, quantity, rack_type, rim_diameter, rim_width, ring_size, screen_size, section_width, series, set_includes, set, size_type, size, skirt_length, sleeve_length, sport_activity, sport, storage_capacity, style, type, unit_quantity, unit_type, upper_material, us_shoe_size, vintage, voltage, volume, waist_size, wheel_diameter, year

Optional

A key-value list of attributes that will be displayed in the details section of the product. The values are string format.

Keys applicable to rentals/real estate: property_type (required), sale_type, bed_bath, area_size, pet_friendly, ac_type, heating_type, laundry_type, parking_type, parkingSpace, furnishing_type, garden_type, tenure_type, listed_by, property_tax_and_condo_fee, construction_status, lease_duration, energy_rating_eu, co2_emission_rating

Keys applicable to vehicles: vehicle_type, year, make, model, number_of_owners, trim, body_style, exterior_color, interior_color, transmission, fuel_type, mileage, money_still_owed, motorcycle_type, engine_size

partner_product_location

String

Optional

Location of the item as string to be displayed. Example: “Paris, France”. No restrictions on how specific or broad this can be.

partner_delivery_method

Array of string enums {shipping, in_person}

Optional

This captures how the product can be delivered to a buyer. If a product can be shipped and picked up in person, include both.
Example: [“shipping”,”in_person”]

Default: [“shipping”]

partner_item_longitude

Float

Optional

Longitude of the item. Required if delivery method includes “in_person”.

partner_shipping_cost

Float

Optional

Required if partner_shipping_type is ‘fixed’.
Example “14.95”

partner_auction_bid_close_time

UNIX timestamp in seconds UTC (number)

Optional

Required field if the partner_listing_type is ‘auction’. This is when the bidding closes for the product. Example: “partner_auction_bid_close_time”: 1713917255

additional_fields

Nullable json object

Freeform (no set enum / keys)

{ “revised_title”: “Premium Blue T-Shirt” }

Optional

A freeform Json field for partners to send any additional fields.