---
title: "SSENSE API: Search | Perceptlayer"
description: "Search from SSENSE as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/ssense/search
---

[APIs](https://perceptlayer.com/apis) / [SSENSE](https://perceptlayer.com/apis/ssense) / Search

# SSENSE: Search

Search from SSENSE as JSON. 1 credit per successful call.

GET `/v1/ssense/search`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `gender` | string | Required | men, women |
| `query` | string | Optional | Up to 100 characters |
| `designer` | string | Optional | Up to 80 characters |
| `category` | string | Optional | Up to 120 characters |
| `sale_only` | boolean | Optional | Any |
| `sort` | string | Optional | recommended, latest, price-asc, price-desc, discount-desc |
| `page` | integer | Optional | Any |
| `country` | string | Optional | US, CA, GB |

## Example request

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.

[Run this endpoint in the playground](https://perceptlayer.com/apis/ssense?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.