Happy Endpoint

product availability

Check product availability at a coordinates and raduis.

GET
/product-availability

Authorization

RapidApiKey
X-RapidAPI-Key<token>

In: header

Query Parameters

skuId*string

SKU ID of product

Length1 <= length
latitude*string

Latitude

longitude*string

Longitude

radius?string

Search radius in miles

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/product-availability?skuId=2495505&latitude=41.78874829999999&longitude=-87.7664934" \  -H "X-RapidAPI-Host: real-time-sephora-api.p.rapidapi.com"
{
  "success": true,
  "data": {
    "success": true,
    "data": {
      "storeMessages": [
        {
          "messageContext": "storeMessages",
          "messages": [
            "This item is available at the following stores (last updated 3 hours ago)."
          ],
          "type": "message"
        }
      ],
      "stores": [
        {
          "address": {
            "address1": "7608 La Crosse Ave",
            "address2": "",
            "city": "Burbank",
            "country": "US",
            "crossStreet": "",
            "fax": "",
            "mallName": "",
            "phone": "(708) 499-3900",
            "postalCode": "60459",
            "state": "IL"
          },
          "availabilityStatus": "In Stock",
          "displayName": "at Kohl's Burbank",
          "distance": 3,
          "inStoreAvailability": 83,
          "latitude": 41.755,
          "longitude": -87.745,
          "seoCanonicalUrl": "/happening/stores/kohls-at-burbank",
          "storeId": "800063",
          "storeType": "SIKLS",
          "targetUrl": "/happening/stores/kohls-at-burbank"
        }
      ]
    }
  }
}
{
  "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"
}