GET /brands/:id_or_alias/products

GET /brands/{id_or_alias}/products

Returns products for a particular brand via the brandId

Path parameters

id_or_alias string Required

ID of the resource to return

Query parameters

ft_bool_non_comedogenic boolean

Search by Feature Non-Comedogenic
ft_bool_allergen_free boolean

Search by Feature Allergen Free
ft_bool_alcohol_free boolean

Search by Feature Alcohol Free
ft_bool_gluten_free boolean

Search by Feature Gluten Free
ft_bool_silicone_free boolean

Search by Feature Silicone Free
ft_bool_sulfate_free boolean

Search by Feature Sulfate Free
ft_bool_paraben_free boolean

Search by Feature Paraben Free
ft_bool_peg_free boolean

Search by Feature PEG Free
ft_bool_fungal_acne_feeding_free boolean

Search by Feature Fungal Acne Feeding Free
ft_bool_fragrance_free boolean

Search by Feature Fragrance Free
ft_bool_moisturising boolean

Search by Feature Moisturising
ft_bool_softening boolean

Search by Feature Softening
ft_bool_soothing boolean

Search by Feature Soothing
ft_bool_acne_fighting boolean

Search by Feature Acne Fighting
ft_bool_anti_aging boolean

Search by Feature Anti-Aging
ft_bool_healing boolean

Search by Feature Healing
ft_bool_antiseptic boolean

Search by Feature Antiseptic
ft_bool_whitening boolean

Search by Feature Brightening
ft_bool_uv_protecting boolean

Search by Feature UV Protecting
ft_bool_antioxidant boolean

Search by Feature Antioxidant

Responses

200

successful operation
Hide response attributes Show response attributes object
- data array[object]
  
  Hide data attributes Show data attributes array[object]
  
  id integer(int32)
  
  title string
  
  full_title string
  
  alias string
  
  raw_label string
  
  image string(nullable)
  
  asin string
  
  published boolean
  
  created_at string(DateTime)
  
  updated_at string(DateTime)
  
  deprecated_at string(nullable)
  
  deprecated_reason string(nullable)
  
  ingredient_count integer(int32)
  
  brand_id integer(int32)
  
  category_id integer(int32)
  
  owner_user_id integer(int32)
  
  ft_bool_non_comedogenic boolean
  
  ft_bool_allergen_free boolean
  
  ft_bool_alcohol_free boolean
  
  ft_bool_gluten_free boolean
  
  ft_bool_silicone_free boolean
  
  ft_bool_sulfate_free boolean
  
  ft_bool_paraben_free boolean
  
  ft_bool_peg_free boolean
  
  ft_bool_fungal_acne_feeding_free boolean
  
  ft_bool_fragrance_free boolean
  
  ft_bool_moisturising boolean
  
  ft_bool_softening boolean
  
  ft_bool_soothing boolean
  
  ft_bool_acne_fighting boolean
  
  ft_bool_anti_aging boolean
  
  ft_bool_healing boolean
  
  ft_bool_antiseptic boolean
  
  ft_bool_whitening boolean
  
  ft_bool_uv_protecting boolean
  
  ft_bool_antioxidant boolean
  
  ft_bool_ceramide boolean
  
  ft_bool_vitamin boolean
  
  ft_bool_pha boolean
  
  ft_bool_bha boolean
  
  ft_bool_aha boolean
  
  ft_bool_hyaluronic_acid boolean
  
  ft_bool_retinoid boolean
  
  ft_bool_niacinamide boolean
  
  brand object
  
  Hide brand attributes Show brand attributes object
  
  id integer
  
  alias string
  
  title string
  
  created_at string(DateTime)
  
  updated_at string(DateTime)
  
  owner_user_id integer
  
  category object
  
  Hide category attributes Show category attributes object
  
  id integer(int32)
  
  title string
  
  alias string
  
  menuindex integer(int32)
  
  created_at string(DateTime)
  
  updated_at string(DateTime)
  
  parent_id integer(int32)
  
  product_image object
  
  Hide product_image attributes Show product_image attributes object
  
  id integer
  
  product_id integer
  
  product_draft_id integer
  
  image string
  
  url string
- links object
  
  Hide links attributes Show links attributes object
  
  first string(url)
  
  last string(url)
  
  prev string(url)
  
  next string(url)
400

Bad Request
401

Authorization information is missing or invalid.
404

Requested Products For This Brand Not Found
500

Server Error

GET /brands/{id_or_alias}/products

curl \
 -X GET https://api.cosmily.com/api/v1/brands/{id_or_alias}/products \
 -H "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "data": [
    {
      "id": 398,
      "brand": {
        "id": 4,
        "alias": "susanne-kaufmann",
        "title": "Susanne Kaufmann",
        "owner_user_id": 1,
        "created_at": "2021-10-04T13:32:53.000Z",
        "updated_at": "2021-11-13T20:23:18.000Z"
      },
      "category": {
        "id": 18,
        "title": "Sunscreens",
        "alias": "sunscreens",
        "parent": 1,
        "menuindex": 100,
        "created_at": "2021-10-04T13:32:53.000Z",
        "updated_at": "2021-11-13T20:23:18.000Z"
      },
      "title": "Sun Cream Cell Protection SPF 25",
      "full_title": "Susanne Kaufmann Sun Cream Cell Protection SPF 25",
      "alias": "susanne-kaufmann-sun-cream-cell-protection-spf-25",
      "raw_label": "Salicylic Acid, Water, Cetyl Alcohol, PPG-15 Stearyl Ether, Polyethylene, Microcrystalline Wax, Steareth-21, Polysorbate 60, Potassium Cetyl Phosphate, Xanthan Gum, Fragrance, Menthyl Lactate, Ferric Ferrocyanide, Jojoba Esters",
      "image": "products/398/398",
      "asin": null,
      "created_at": "2021-10-05T14:21:25.000Z",
      "updated_at": "2021-11-13T20:23:18.000Z",
      "deprecated_at": null,
      "deprecated_reason": null,
      "ingredient_count": 16,
      "ft_bool_non_comedogenic": false,
      "ft_bool_allergen_free": true,
      "ft_bool_alcohol_free": true,
      "ft_bool_gluten_free": true,
      "ft_bool_silicone_free": true,
      "ft_bool_sulfate_free": true,
      "ft_bool_paraben_free": true,
      "ft_bool_peg_free": true,
      "ft_bool_fungal_acne_feeding_free": false,
      "ft_bool_fragrance_free": false,
      "ft_bool_moisturising": true,
      "ft_bool_softening": true,
      "ft_bool_soothing": true,
      "ft_bool_acne_fighting": true,
      "ft_bool_anti_aging": false,
      "ft_bool_healing": false,
      "ft_bool_antiseptic": true,
      "ft_bool_whitening": false,
      "ft_bool_uv_protecting": false,
      "ft_bool_antioxidant": false,
      "ft_bool_ceramide": false,
      "ft_bool_vitamin": false,
      "ft_bool_pha": false,
      "ft_bool_bha": false,
      "ft_bool_aha": false,
      "ft_bool_hyaluronic_acid": false,
      "ft_bool_retinoid": false,
      "ft_bool_niacinamide": false
    }
  ],
  "links": {
    "first": "/api/v1/brands/4/products?page=1",
    "last": "/api/v1/brands/4/products?page=1"
  }
}

Response examples (200)

{
  "data": [
    {
      "id": 398,
      "asin": null,
      "alias": "susanne-kaufmann-sun-cream-cell-protection-spf-25",
      "brand": {
        "id": 4,
        "alias": "susanne-kaufmann",
        "title": "Susanne Kaufmann",
        "created_at": "2021-10-04T13:32:53.000Z",
        "updated_at": "2021-11-13T20:23:18.000Z",
        "owner_user_id": 1
      },
      "image": "products/398/398",
      "title": "Sun Cream Cell Protection SPF 25",
      "category": {
        "id": 18,
        "alias": "sunscreens",
        "title": "Sunscreens",
        "parent": 1,
        "menuindex": 100,
        "created_at": "2021-10-04T13:32:53.000Z",
        "updated_at": "2021-11-13T20:23:18.000Z"
      },
      "raw_label": "Salicylic Acid, Water, Cetyl Alcohol, PPG-15 Stearyl Ether, Polyethylene, Microcrystalline Wax, Steareth-21, Polysorbate 60, Potassium Cetyl Phosphate, Xanthan Gum, Fragrance, Menthyl Lactate, Ferric Ferrocyanide, Jojoba Esters",
      "created_at": "2021-10-05T14:21:25.000Z",
      "full_title": "Susanne Kaufmann Sun Cream Cell Protection SPF 25",
      "updated_at": "2021-11-13T20:23:18.000Z",
      "ft_bool_aha": false,
      "ft_bool_bha": false,
      "ft_bool_pha": false,
      "deprecated_at": null,
      "ft_bool_healing": false,
      "ft_bool_vitamin": false,
      "ft_bool_ceramide": false,
      "ft_bool_peg_free": true,
      "ft_bool_retinoid": false,
      "ft_bool_soothing": true,
      "ingredient_count": 16,
      "deprecated_reason": null,
      "ft_bool_softening": true,
      "ft_bool_whitening": false,
      "ft_bool_anti_aging": false,
      "ft_bool_antiseptic": true,
      "ft_bool_antioxidant": false,
      "ft_bool_gluten_free": true,
      "ft_bool_niacinamide": false,
      "ft_bool_alcohol_free": true,
      "ft_bool_moisturising": true,
      "ft_bool_paraben_free": true,
      "ft_bool_sulfate_free": true,
      "ft_bool_acne_fighting": true,
      "ft_bool_allergen_free": true,
      "ft_bool_silicone_free": true,
      "ft_bool_uv_protecting": false,
      "ft_bool_fragrance_free": false,
      "ft_bool_hyaluronic_acid": false,
      "ft_bool_non_comedogenic": false,
      "ft_bool_fungal_acne_feeding_free": false
    }
  ],
  "links": {
    "last": "/api/v1/brands/4/products?page=1",
    "first": "/api/v1/brands/4/products?page=1"
  }
}