/netaporter/products

POST /api/netaporter/products

Price: 10 credits

Get one Net-a-Porter product by id or URL: designer, price and discount in the region currency, every color with its sizes and live stock status, descriptions, details and care, size and fit, images, videos, categories and attributes

How to use it

Fetch the full Net-a-Porter product for a product URL, a color id as returned by the Net-a-Porter search and category endpoints, or a product id ending in P. Prices follow region.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• product string required — Net-a-Porter product id or product page URL (examples: "https://www.net-a-porter.com/en-us/shop/product/gucci/clothing/capes/shearling-trimmed-leather-cape/46376663163189917", "46376663163189917", "46376663163189916P"; minLength: 1)
• region string — Store region; it sets the assortment and the currency (default: "us"; one of: "us", "ca")

Response

• @type string (default: "NetaporterProduct")
• id string required
• catalog_id string nullable
• manufacturer_code string nullable
• selected_color_id string nullable
• name string nullable
• designer string nullable
• designer_id string nullable
• designer_url string nullable
• url string nullable
• region string nullable
• price object nullable
  • @type string (default: "NetaporterPrice")
  • currency string nullable
  • currency_symbol string nullable
  • price number nullable
  • original_price number nullable
  • discount_percent number nullable
  • price_rounded number nullable
  • original_price_rounded number nullable
  • is_from_price boolean nullable
• stock_status string nullable
• is_in_stock boolean nullable
• first_visible_at string nullable
• size_scheme string nullable
• designer_cart_limit integer nullable
• is_buyable boolean nullable
• is_visible boolean nullable
• is_displayable boolean nullable
• is_login_required boolean nullable
• is_on_sale boolean nullable
• is_final_sale boolean nullable
• is_promo boolean nullable
• is_not_stocked_online boolean nullable
• image string nullable
• badges array (default: [])
  • @type string (default: "NetaporterBadge-Output")
  • code string required
  • label string nullable
  • badge_type string nullable
• categories array (default: [])
  • @type string (default: "NetaporterCategoryRef")
  • id string required
  • code string nullable
  • name string nullable
  • path string nullable
• sales_categories array (default: [])
  • @type string (default: "NetaporterSalesCategory")
  • is_primary boolean nullable
  • levels array (default: [])
    • @type string (default: "NetaporterCategoryRef")
    • id string required
    • code string nullable
    • name string nullable
    • path string nullable
• merchandising array (default: [])
  • @type string (default: "NetaporterAttribute")
  • name string required
  • values array (default: [])
• attributes array (default: [])
  • @type string (default: "NetaporterAttribute")
  • name string required
  • values array (default: [])
• colors array (default: [])
  • @type string (default: "NetaporterColorVariant")
  • id string required
  • catalog_id string nullable
  • manufacturer_code string nullable
  • color string nullable
  • color_code string nullable
  • color_hex string nullable
  • name string nullable
  • url string nullable
  • price object nullable
    • @type string (default: "NetaporterPrice")
    • currency string nullable
    • currency_symbol string nullable
    • price number nullable
    • original_price number nullable
    • discount_percent number nullable
    • price_rounded number nullable
    • original_price_rounded number nullable
    • is_from_price boolean nullable
  • stock_status string nullable
  • is_in_stock boolean nullable
  • is_buyable boolean nullable
  • is_visible boolean nullable
  • is_displayable boolean nullable
  • is_default boolean nullable
  • is_selected boolean nullable
  • is_banned boolean nullable
  • is_login_required boolean nullable
  • is_on_sale boolean nullable
  • is_sale_exclusive boolean nullable
  • is_final_sale boolean nullable
  • is_promo boolean nullable
  • is_not_stocked_online boolean nullable
  • is_pre_order boolean nullable
  • first_visible_at string nullable
  • size_scheme string nullable
  • description string nullable
  • details_and_care array (default: [])
  • size_and_fit array (default: [])
  • technical_description string nullable
  • seo_title string nullable
  • meta_description string nullable
  • meta_keywords string nullable
  • legacy_id string nullable
  • image string nullable
  • images array (default: [])
  • videos array (default: [])
  • swatch_image string nullable
  • badges array (default: [])
    • @type string (default: "NetaporterBadge-Output")
    • code string required
    • label string nullable
    • badge_type string nullable
  • merchandising array (default: [])
    • @type string (default: "NetaporterAttribute")
    • name string required
    • values array (default: [])
  • attributes array (default: [])
    • @type string (default: "NetaporterAttribute")
    • name string required
    • values array (default: [])
  • skus array (default: [])
    • @type string (default: "NetaporterSku")
    • gtin string required
    • sku_id string nullable
    • manufacturer_code string nullable
    • size string nullable
    • size_label string nullable
    • size_central string nullable
    • size_scale string nullable
    • size_conversions array (default: [])
    • composition string nullable
    • price object nullable (see schema NetaporterPrice)
    • stock_status string nullable
    • is_in_stock boolean nullable
    • is_buyable boolean nullable
    • is_displayable boolean nullable
    • is_banned boolean nullable
    • is_login_required boolean nullable
    • is_not_stocked_online boolean nullable
    • is_pre_order boolean nullable
    • has_local_stock boolean nullable
    • badges array (default: [])
    • measurements array (default: [])
    • attributes array (default: [])

Errors

• 422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.
• 408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.
• 412 — No Net-a-Porter product has this id Retrying will not help: either the entity does not exist, or the input points at a different one.
• 429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.
• 500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.
• 529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.

Response headers

• X-Error — Error message text (present only on error)
• X-Request-ID — Unique request identifier
• X-Execution-Time — Execution time in seconds
• X-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.
• X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.
• X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.
• X-Retry-After — Seconds to wait before retrying. Present only on 429.