Sign inGet a free API keyDashboard
Menu

APIs / Marketplaces / SSENSE

1 credit per call2 endpoints11 datapoints

SSENSE API

SSENSE API for men's and women's product search by designer, category and sale, with prices and product details as JSON. 1 credit per successful call.

Get a free API keyRun it below
SSENSE
GET/v1/ssense/search?gender=women
{
  "success": true,
  "data": {
    "items": [
      {
        "id": "19458441",
        "sku": "262020F070011",
        "name": "SSENSE Exclusive Brown Jersey Moon Catsuit",
        "brand": "Marine Serre",
        "url": "https://www.ssense.com/en-us/women/product/marine-serre/ssense-exclusive-brown-jersey-moon-catsuit/19458441",
        "gender": "women",
        "category_ids": [
          3,
          74
        ],
        "price": {
          "amount": 700,
          "currency": "USD"
        },
        "on_sale": false,
        "in_stock": true,
        "images": [
          "https://res.cloudinary.com/ssenseweb/image/upload/w_1280,c_limit,h_1920,f_jpg,q_auto:best/262020F070011_1.jpg"
        ]
      },
      {
        "id": "19407081",
        "sku": "262020F070001",
        "name": "Black Recycled Jersey Moon Catsuit",
        "brand": "Marine Serre",
        "url": "https://www.ssense.com/en-us/women/product/marine-serre/black-recycled-jersey-moon-catsuit/19407081",
        "gender": "women",
        "category_ids": [
          3,
          74
        ],
        "price": {
          "amount": 700,
          "currency": "USD"
        },
        "on_sale": false,
        "in_stock": true,
        "images": [
          "https://res.cloudinary.com/ssenseweb/image/upload/w_1280,c_limit,h_1920,f_jpg,q_auto:best/262020F070001_1.jpg"
        ]
      },
      {
        "id": "19407091",
        "sku": "262020F070002",
        "name": "Tan Recycled Jersey Moon Catsuit",
        "brand": "Marine Serre",
        "url": "https://www.ssense.com/en-us/women/product/marine-serre/tan-recycled-jersey-moon-catsuit/19407091",
        "gender": "women",
        "category_ids": [
          3,
          74
        ],
        "price": {
          "amount": 700,
          "currency": "USD"
        },
        "on_sale": false,
        "in_stock": true,
        "images": [
          "https://res.cloudinary.com/ssenseweb/image/upload/w_1280,c_limit,h_1920,f_jpg,q_auto:best/262020F070002_1.jpg"
        ]
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 120,
      "total_pages": 174,
      "has_more": true
    },
    "filters": {
      "gender": "women",
      "sale_only": false,
      "sort": "recommended"
    },
    "country": "US",
    "currency": "USD"
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_f450ca0ee5e84806915c7902f5278845",
    "credits_charged": 1,
    "credits_remaining": 1915
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#idstringskustringnamestringbrandstringurlurlgenderstringcategory_idsnumber[]priceobjecton_salebooleanin_stockbooleanimagesstring[]
119458441262020F070011SSENSE Exclusive Brown Jersey Moon CatsuitMarine Serrehttps://www.ssense.com/en-us/women/product/marine-serre/ssense-exclusive-brown-jersey-moon-catsuit/19458441women[2 items]{2 fields}falsetrue[1 item]
219407081262020F070001Black Recycled Jersey Moon CatsuitMarine Serrehttps://www.ssense.com/en-us/women/product/marine-serre/black-recycled-jersey-moon-catsuit/19407081women[2 items]{2 fields}falsetrue[1 item]
319407091262020F070002Tan Recycled Jersey Moon CatsuitMarine Serrehttps://www.ssense.com/en-us/women/product/marine-serre/tan-recycled-jersey-moon-catsuit/19407091women[2 items]{2 fields}falsetrue[1 item]

Recorded from our API · 3 items shown · 11 datapoints per itemGET /v1/ssense/search?gender=women

11 datapoints

Identity

  • idstring
  • skustring
  • namestring
  • brandstring
  • category_idsnumber[]

Contact

  • urlurl

Reputation

  • imagesstring[]

Price

  • priceobject

Other

  • genderstring
  • on_saleboolean
  • in_stockboolean

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/ssense/search?gender=women" \
  -H "X-API-Key: $API_KEY"

SSENSE · 2 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/ssense/product
none+6 optional
1 credit
GET/v1/ssense/search
gender+7 optional
1 credit

Overview

What you can get

The SSENSE API returns SSENSE product data as JSON through 2 endpoints. Both take an optional country (US, CA or GB).

  • Search: search takes a gender (men or women), with query, designer, category, sale_only, sort (recommended, latest, price-asc, price-desc or discount-desc) and page.
  • Products: product takes a url or an id, with brand, slug and gender (men or women).

The recorded search for gender=women returns items, each with id, sku, name, brand, url, gender, category_ids, price, on_sale, in_stock and images. It also returns pagination with total_pages (174 in that recording) and has_more, the filters used, and the country and currency.

How a call works

Search a department: GET /v1/ssense/search?gender=women with your key in the X-API-Key header. Add designer, category or sale_only to narrow it. Each result carries an id and a url, which product takes. Every successful call costs 1 credit; failed calls cost nothing.

MarketplacesJSONRESTMCP

More marketplaces APIs

About YouadidasAliExpressAllegroAmazonASOSBilliger.debol.comChrono24CostcoCraigslistDBA

Use cases

Track a designer's prices and sale status

Use the SSENSE API to track a designer's prices and sale status

Find the deepest markdowns with `sort=discount-desc` and `sale_only`

Use the SSENSE API to find the deepest markdowns with `sort=discount-desc` and `sale_only`

Watch new arrivals with `sort=latest`

Use the SSENSE API to watch new arrivals with `sort=latest`

Check whether a product is in stock

Use the SSENSE API to check whether a product is in stock

FAQ

Questions

How much does the SSENSE API cost?

Each successful call costs one credit, and each search page is one call. New accounts get free credits to start, and credit packs bring the price down as you scale.

Can I search only sale items?

Yes. Pass `sale_only` to `search`.

Do I need an SSENSE account?

No. You call this SSENSE API with your Perceptlayer key in the `X-API-Key` header, with no SSENSE login.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Should I build a SSENSE scraper instead?

You can, but a SSENSE scraper is code you maintain: page changes break it, requests get blocked, and SSENSE's terms govern how you collect data. The SSENSE API gives you 2 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the SSENSE API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs