Change Updates

Do not miss any Cosmily API changes, ever again

Subscribe to the Cosmily API changelog to be up to date on recent changes.

RSS
Cosmily API documentation

Changelog

Last update:
Compare
27 structure changes including:
27 Modifications
Modified 27 Breaking
GET /articles
  • Authentication
  • Bearer token authentication method Removed
GET /articles/{id_or_alias}
  • Authentication
  • Bearer token authentication method Removed
GET /brands
  • Authentication
  • Bearer token authentication method Removed
GET /brands/{id_or_alias}
  • Authentication
  • Bearer token authentication method Removed
GET /brands/{id_or_alias}/products
  • Authentication
  • Bearer token authentication method Removed
GET /breadcrumbs/product/{id_or_alias}
  • Authentication
  • Bearer token authentication method Removed
GET /breadcrumbs/product_category/{id_or_alias}
  • Authentication
  • Bearer token authentication method Removed
GET /buy/{id_or_alias}/amzn
  • Authentication
  • Bearer token authentication method Removed
GET /featured
  • Authentication
  • Bearer token authentication method Removed
GET /ingredients
  • Authentication
  • Bearer token authentication method Removed
GET /ingredients/{id_or_alias}
  • Authentication
  • Bearer token authentication method Removed
GET /ingredients/{id_or_alias}/products
  • Authentication
  • Bearer token authentication method Removed
GET /product_categories
  • Authentication
  • Bearer token authentication method Removed
GET /product_categories/{id_or_alias}
  • Authentication
  • Bearer token authentication method Removed
GET /product_categories/{id_or_alias}/products
  • Authentication
  • Bearer token authentication method Removed
GET /product_drafts
  • Authentication
  • Bearer token authentication method Removed
GET /product_drafts/{id}
  • Authentication
  • Bearer token authentication method Removed
GET /products
  • Authentication
  • Bearer token authentication method Removed
GET /products/{id_or_alias}
  • Authentication
  • Bearer token authentication method Removed
GET /products/{id_or_alias}/analysis
  • Authentication
  • Bearer token authentication method Removed
POST /analyze/ingredient_list
  • Authentication
  • Bearer token authentication method Removed
POST /ingredients/create
  • Authentication
  • Bearer token authentication method Removed
  • Response
  • 500 response Added
POST /product_drafts/approve
  • Authentication
  • Bearer token authentication method Removed
  • Response
  • 500 response Added
POST /product_drafts/auto_classify
  • Authentication
  • Bearer token authentication method Removed
  • Response
  • 500 response Added
POST /product_drafts/create
  • Authentication
  • Bearer token authentication method Removed
  • Response
  • 500 response Added
POST /product_drafts/update
  • Authentication
  • Bearer token authentication method Removed
POST /products/search
  • Authentication
  • Bearer token authentication method Removed
8 structure changes including:
8 Modifications
Modified 8 Breaking
GET /brands/{id_or_alias}/products
  • Response
  • 200 response Modified
    • data attribute Modified
  • Query
  • ft_bool_protecting query parameter Removed
GET /ingredients
  • Response
  • 200 response Modified
    • data attribute Modified
  • Query
  • prop_bool_protecting query parameter Removed
GET /ingredients/{id_or_alias}
  • Response
  • 200 response Modified
    • data attribute Modified
GET /ingredients/{id_or_alias}/products
  • Response
  • 200 response Modified
    • data attribute Modified
  • Query
  • ft_bool_protecting query parameter Removed
GET /product_categories/{id_or_alias}/products
  • Response
  • 200 response Modified
    • data attribute Modified
  • Query
  • ft_bool_protecting query parameter Removed
GET /products
  • Response
  • 200 response Modified
    • data attribute Modified
  • Query
  • ft_bool_protecting query parameter Removed
GET /products/{id_or_alias}
  • Response
  • 200 response Modified
    • data attribute Modified
POST /products/search
  • Response
  • 200 response Modified
    • data attribute Modified
29 structure changes including:
2 Additions
27 Modifications
Modified 27 Breaking
GET /articles
  • Authentication
  • Bearer token authentication method Added
GET /articles/{id_or_alias}
  • Authentication
  • Bearer token authentication method Added
GET /brands
  • Authentication
  • Bearer token authentication method Added
GET /brands/{id_or_alias}
  • Authentication
  • Bearer token authentication method Added
GET /brands/{id_or_alias}/products
  • Authentication
  • Bearer token authentication method Added
GET /breadcrumbs/product/{id_or_alias}
  • Authentication
  • Bearer token authentication method Added
GET /breadcrumbs/product_category/{id_or_alias}
  • Authentication
  • Bearer token authentication method Added
GET /buy/{id_or_alias}/amzn
  • Authentication
  • Bearer token authentication method Added
GET /featured
  • Authentication
  • Bearer token authentication method Added
GET /ingredients
  • Authentication
  • Bearer token authentication method Added
GET /ingredients/{id_or_alias}
  • Authentication
  • Bearer token authentication method Added
GET /ingredients/{id_or_alias}/products
  • Authentication
  • Bearer token authentication method Added
GET /product_categories
  • Authentication
  • Bearer token authentication method Added
GET /product_categories/{id_or_alias}
  • Authentication
  • Bearer token authentication method Added
GET /product_categories/{id_or_alias}/products
  • Authentication
  • Bearer token authentication method Added
GET /product_drafts
  • Authentication
  • Bearer token authentication method Added
GET /product_drafts/{id}
  • Authentication
  • Bearer token authentication method Added
GET /products
  • Authentication
  • Bearer token authentication method Added
GET /products/{id_or_alias}
  • Authentication
  • Bearer token authentication method Added
GET /products/{id_or_alias}/analysis
  • Authentication
  • Bearer token authentication method Added
POST /analyze/ingredient_list
  • Response
  • 200 response Removed
  • 201 response Added
  • Authentication
  • Bearer token authentication method Added
POST /ingredients/create
  • Authentication
  • Bearer token authentication method Added
POST /product_drafts/approve
  • Authentication
  • Bearer token authentication method Added
POST /product_drafts/auto_classify
  • Authentication
  • Bearer token authentication method Added
POST /product_drafts/create
  • Authentication
  • Bearer token authentication method Added
POST /product_drafts/update
  • Authentication
  • Bearer token authentication method Added
POST /products/search
  • Authentication
  • Bearer token authentication method Added
Added 2
GET /analyze/shared/{token}
POST /compare/track
27 structure changes including:
27 Modifications
Modified 27 Breaking
GET /articles
  • Response
  • 401 response Added
GET /articles/{id_or_alias}
  • Response
  • 401 response Added
GET /brands
  • Response
  • 401 response Added
GET /brands/{id_or_alias}
  • Response
  • 401 response Added
GET /brands/{id_or_alias}/products
  • Response
  • 401 response Added
GET /breadcrumbs/product/{id_or_alias}
  • Response
  • 401 response Added
GET /breadcrumbs/product_category/{id_or_alias}
  • Response
  • 401 response Added
GET /buy/{id_or_alias}/amzn
  • Response
  • 401 response Added
GET /featured
  • Response
  • 401 response Added
GET /ingredients
  • Response
  • 401 response Added
GET /ingredients/{id_or_alias}
  • Response
  • 401 response Added
GET /ingredients/{id_or_alias}/products
  • Response
  • 401 response Added
GET /product_categories
  • Response
  • 401 response Added
GET /product_categories/{id_or_alias}
  • Response
  • 401 response Added
GET /product_categories/{id_or_alias}/products
  • Response
  • 401 response Added
GET /product_drafts
  • Response
  • 401 response Added
GET /product_drafts/{id}
  • Response
  • 401 response Added
GET /products
  • Response
  • 401 response Added
GET /products/{id_or_alias}
  • Response
  • 401 response Added
GET /products/{id_or_alias}/analysis
  • Response
  • 401 response Added
POST /analyze/ingredient_list
  • Response
  • 401 response Added
POST /ingredients/create
  • Response
  • 401 response Added
POST /product_drafts/approve
  • Response
  • 201 response Removed
  • 200, 401 responses Added
POST /product_drafts/auto_classify
  • Response
  • 201 response Removed
  • 200, 401 responses Added
POST /product_drafts/create
  • Response
  • 401 response Added
POST /product_drafts/update
  • Response
  • 201 response Removed
  • 200, 401 responses Added
POST /products/search
  • Response
  • 401, 500 responses Added
5 structure changes including:
1 Addition
4 Modifications
Modified 4 Breaking
POST /product_drafts/approve
  • Response
  • 200 response Removed
  • 201, 422 responses Added
POST /product_drafts/auto_classify
  • Response
  • 200 response Removed
  • 201, 422 responses Added
POST /product_drafts/create
  • Response
  • 200 response Removed
  • 201, 422 responses Added
POST /product_drafts/update
  • Response
  • 200 response Removed
  • 201, 422 responses Added
Added 1
POST /ingredients/create
6 structure changes including:
4 Additions
2 Modifications
Modified 2 Breaking
GET /product_drafts
  • Response
  • 200 response Modified
    • reviewer_user_id attribute Modified
    • product_attributes attribute Modified
GET /product_drafts/{id}
  • Response
  • 200 response Modified
    • reviewer_user_id attribute Modified
    • product_attributes attribute Modified
Added 4
POST /product_drafts/approve
POST /product_drafts/auto_classify
POST /product_drafts/create
POST /product_drafts/update
3 structure changes including:
3 Modifications
Modified 3
GET /breadcrumbs/product/{id_or_alias}
  • Path
  • id_or_alias path parameter Added
GET /breadcrumbs/product_category/{id_or_alias}
  • Path
  • id_or_alias path parameter Added
GET /product_categories/{id_or_alias}
  • Path
  • id_or_alias path parameter Added
1 structure change including:
1 Modification
Modified 1
GET /featured
  • Query
  • products_count, comparisons_count, articles_count, as_of_date query parameters Added
4 structure changes including:
3 Additions
1 Modification
Modified 1
GET /product_categories
  • Response
  • 200 response Modified
    • data attribute Modified
Added 3
GET /breadcrumbs/product/{id_or_alias}
GET /breadcrumbs/product_category/{id_or_alias}
GET /product_categories/{id_or_alias}
1 structure change including:
1 Modification
Modified 1
GET /product_categories/{id_or_alias}/products
  • Query
  • search query parameter Added
1 structure change including:
1 Modification
Modified 1 Breaking
GET /products
  • Query
  • ft_bool_non_comedogenic query parameter Modified
1 structure change including:
1 Addition
Added 1
POST /products/search
18 structure changes including:
18 Modifications
Modified 18
GET /articles
  • Response
  • 500 response Added
GET /articles/{id_or_alias}
  • Response
  • 500 response Added
GET /brands
  • Response
  • 500 response Added
GET /brands/{id_or_alias}
  • Response
  • 500 response Added
GET /brands/{id_or_alias}/products
  • Response
  • 500 response Added
GET /buy/{id_or_alias}/amzn
  • Response
  • 500 response Added
GET /featured
  • Response
  • 500 response Added
GET /ingredients
  • Response
  • 500 response Added
GET /ingredients/{id_or_alias}
  • Response
  • 500 response Added
GET /ingredients/{id_or_alias}/products
  • Response
  • 500 response Added
GET /product_categories
  • Response
  • 500 response Added
GET /product_categories/{id_or_alias}/products
  • Response
  • 500 response Added
GET /product_drafts
  • Response
  • 500 response Added
GET /product_drafts/{id}
  • Response
  • 500 response Added
GET /products
  • Response
  • 500 response Added
GET /products/{id_or_alias}
  • Response
  • 500 response Added
GET /products/{id_or_alias}/analysis
  • Response
  • 500 response Added
POST /analyze/ingredient_list
  • Response
  • 500 response Added
2 structure changes including:
1 Addition
1 Modification
Modified 1
GET /products/{id_or_alias}
  • Response
  • 200 response Modified
    • links attribute Added
Added 1
GET /buy/{id_or_alias}/amzn
6 structure changes including:
6 Modifications
Modified 6 Breaking
GET /product_categories
  • Response
  • 200 response Modified
    • data attribute Modified
GET /product_categories/{id_or_alias}/products
  • Response
  • 200 response Modified
    • data attribute Modified
GET /product_drafts
  • Response
  • 200 response Modified
    • id attribute Modified
    • type, attributes attributes Removed
    • author_user_id, reviewer_user_id, product_attributes, ingredient_classifications, draft_version, created_at, updated_at, approved_at attributes Added
GET /product_drafts/{id}
  • Response
  • 200 response Modified
    • id attribute Modified
    • type, attributes attributes Removed
    • author_user_id, reviewer_user_id, product_attributes, ingredient_classifications, draft_version, created_at, updated_at, approved_at attributes Added
GET /products
  • Response
  • 200 response Modified
    • data attribute Modified
GET /products/{id_or_alias}
  • Response
  • 200 response Modified
    • data attribute Modified
4 structure changes including:
3 Additions
1 Modification
Modified 1
GET /product_categories/{id_or_alias}/products
  • Response
  • 200 response Modified
    • data, links attributes Added
Added 3
GET /products/{id_or_alias}
GET /products/{id_or_alias}/analysis
POST /analyze/ingredient_list
1 structure change including:
1 Modification
Modified 1 Breaking
GET /product_categories/{id_or_alias}/products
  • Response
  • 200 response Modified
    • id, type, attributes attributes Removed
5 structure changes including:
5 Modifications
Modified 5
GET /brands/{id_or_alias}/products
  • Query
  • ft_bool_non_comedogenic, ft_bool_allergen_free, ft_bool_alcohol_free, ft_bool_gluten_free, ft_bool_silicone_free, ft_bool_sulfate_free, ft_bool_paraben_free, ft_bool_peg_free, ft_bool_fungal_acne_feeding_free, ft_bool_fragrance_free, ft_bool_moisturising, ft_bool_softening, ft_bool_soothing, ft_bool_acne_fighting, ft_bool_anti_aging, ft_bool_healing, ft_bool_antiseptic, ft_bool_protecting, ft_bool_whitening, ft_bool_uv_protecting, ft_bool_antioxidant query parameters Added
GET /ingredients
  • Query
  • prop_int_comedogenic_rating, prop_bool_antioxidant, prop_bool_moisturising, prop_bool_softening, prop_bool_soothing, prop_bool_acne_fighting, prop_bool_anti_aging, prop_bool_healing, prop_bool_antiseptic, prop_bool_protecting, prop_bool_whitening, prop_bool_uv_protecting, prop_bool_allergen, prop_bool_alcohol, prop_bool_gluten, prop_bool_silicone, prop_bool_sulfate, prop_bool_paraben, prop_bool_peg, prop_bool_fungal_acne_feeding query parameters Added
GET /ingredients/{id_or_alias}/products
  • Query
  • ft_bool_non_comedogenic, ft_bool_allergen_free, ft_bool_alcohol_free, ft_bool_gluten_free, ft_bool_silicone_free, ft_bool_sulfate_free, ft_bool_paraben_free, ft_bool_peg_free, ft_bool_fungal_acne_feeding_free, ft_bool_fragrance_free, ft_bool_moisturising, ft_bool_softening, ft_bool_soothing, ft_bool_acne_fighting, ft_bool_anti_aging, ft_bool_healing, ft_bool_antiseptic, ft_bool_protecting, ft_bool_whitening, ft_bool_uv_protecting, ft_bool_antioxidant query parameters Added
GET /product_categories/{id_or_alias}/products
  • Query
  • ft_bool_non_comedogenic, ft_bool_allergen_free, ft_bool_alcohol_free, ft_bool_gluten_free, ft_bool_silicone_free, ft_bool_sulfate_free, ft_bool_paraben_free, ft_bool_peg_free, ft_bool_fungal_acne_feeding_free, ft_bool_fragrance_free, ft_bool_moisturising, ft_bool_softening, ft_bool_soothing, ft_bool_acne_fighting, ft_bool_anti_aging, ft_bool_healing, ft_bool_antiseptic, ft_bool_protecting, ft_bool_whitening, ft_bool_uv_protecting, ft_bool_antioxidant query parameters Added
GET /products
  • Query
  • ft_bool_non_comedogenic, ft_bool_allergen_free, ft_bool_alcohol_free, ft_bool_gluten_free, ft_bool_silicone_free, ft_bool_sulfate_free, ft_bool_paraben_free, ft_bool_peg_free, ft_bool_fungal_acne_feeding_free, ft_bool_fragrance_free, ft_bool_moisturising, ft_bool_softening, ft_bool_soothing, ft_bool_acne_fighting, ft_bool_anti_aging, ft_bool_healing, ft_bool_antiseptic, ft_bool_protecting, ft_bool_whitening, ft_bool_uv_protecting, ft_bool_antioxidant query parameters Added
7 structure changes including:
7 Modifications
Modified 7
GET /articles
  • Response
  • 400 response Added
GET /brands
  • Response
  • 400 response Added
GET /featured
  • Response
  • 400 response Added
GET /ingredients
  • Response
  • 400 response Added
GET /product_categories
  • Response
  • 400 response Added
GET /product_drafts
  • Response
  • 400 response Added
GET /products
  • Response
  • 400 response Added
2 structure changes including:
2 Modifications
Modified 2 Breaking
GET /brands
  • Query
  • title query parameter Removed
  • search query parameter Added
GET /ingredients
  • Query
  • search query parameter Added