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
  • 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"
  }
}