Happy Endpoint

search by keyword

Search for product using keyword and other parameters

GET
/search-by-keyword

Authorization

RapidApiKey
X-RapidAPI-Key<token>

In: header

Query Parameters

keyword*string

Search keyword

Length1 <= length
sortBy?string

Sort order for results

Default"BEST_SELLING"
Value in"BEST_SELLING" | "TOP_RATED" | "PRICE_LOW_TO_HIGH" | "PRICE_HIGH_TO_LOW" | "NEW"
minPrice?number

Minimum price in $

Range0 <= value
maxPrice?number

Maximum price in $

Range0 <= value
currentPage?number

Current page number

Default1
Range1 <= value
pageSize?number

Number of items per page

Default60
Range1 <= value
minRating?number

Minimum rating filter (1 to 5)

Range1 <= value <= 5
isNew?string

Filter for new products (true/false)

categoryId?string

Get categoryId from Categories List endpoint

Header Parameters

X-RapidAPI-Host*string
Default"real-time-sephora-api.p.rapidapi.com"

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/search-by-keyword?keyword=eyeshadow" \  -H "X-RapidAPI-Host: real-time-sephora-api.p.rapidapi.com"
{
  "success": true,
  "data": null
}
{
  "success": false,
  "message": "Invalid payload provided. Please ensure: 1) 'Content-Type: application/json' is included in your request headers 2) Request body contains valid JSON data.",
  "error": {
    "issues": [
      {
        "code": "too_small",
        "minimum": 1,
        "type": "array",
        "inclusive": true,
        "exact": false,
        "message": "Array must contain at least 1 element(s)",
        "path": [
          "urls"
        ]
      }
    ],
    "name": "ZodError"
  }
}
{
  "success": false,
  "message": "Internal server error"
}