--- title: "SSENSE API: JSON data, 2 endpoints, 1 credit per call" description: "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." url: https://perceptlayer.com/apis/ssense --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / SSENSE 1 credit per call 2 endpoints 11 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 key](https://perceptlayer.com/signup) Run 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 OK JSON X-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. | # | id string | sku string | name string | brand string | url url | gender string | category\_ids number\[\] | price object | on\_sale boolean | in\_stock boolean | images string\[\] | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 19458441 | 262020F070011 | SSENSE Exclusive Brown Jersey Moon Catsuit | Marine Serre | https://www.ssense.com/en-us/women/product/marine-serre/ssense-exclusive-brown-jersey-moon-catsuit/19458441 | women | \[2 items\] | {2 fields} | false | true | \[1 item\] | | 2 | 19407081 | 262020F070001 | Black Recycled Jersey Moon Catsuit | Marine Serre | https://www.ssense.com/en-us/women/product/marine-serre/black-recycled-jersey-moon-catsuit/19407081 | women | \[2 items\] | {2 fields} | false | true | \[1 item\] | | 3 | 19407091 | 262020F070002 | Tan Recycled Jersey Moon Catsuit | Marine Serre | https://www.ssense.com/en-us/women/product/marine-serre/tan-recycled-jersey-moon-catsuit/19407091 | women | \[2 items\] | {2 fields} | false | true | \[1 item\] | Recorded from our API · 3 items shown · 11 datapoints per item GET /v1/ssense/search?gender=women 11 datapoints ### Identity - id string - sku string - name string - brand string - category\_ids number\[\] ### Contact - url url ### Reputation - images string\[\] ### Price - price object ### Other - gender string - on\_sale boolean - in\_stock boolean Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/ssense/product`](https://perceptlayer.com/apis/ssense/product) | none +6 optional | 1 credit | | [GET `/v1/ssense/search`](https://perceptlayer.com/apis/ssense/search) | `gender` +7 optional | 1 credit | Overview ## About the SSENSE API ## 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. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)