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

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 property Modified
  • Query
  • ft_bool_protecting query parameter Removed
GET /ingredients
  • Response
  • 200 response Modified
    • data property Modified
  • Query
  • prop_bool_protecting query parameter Removed
GET /ingredients/{id_or_alias}
  • Response
  • 200 response Modified
    • data property Modified
GET /ingredients/{id_or_alias}/products
  • Response
  • 200 response Modified
    • data property Modified
  • Query
  • ft_bool_protecting query parameter Removed
GET /product_categories/{id_or_alias}/products
  • Response
  • 200 response Modified
    • data property Modified
  • Query
  • ft_bool_protecting query parameter Removed
GET /products
  • Response
  • 200 response Modified
    • data property Modified
  • Query
  • ft_bool_protecting query parameter Removed
GET /products/{id_or_alias}
  • Response
  • 200 response Modified
    • data property Modified
POST /products/search
  • Response
  • 200 response Modified
    • data property Modified
29 structure changes including:
2 Additions
27 Modifications
Modified 27 Breaking
POST /products/search
  • Authentication
  • Bearer token authentication method Added
POST /product_drafts/update
  • Authentication
  • Bearer token authentication method Added
POST /product_drafts/create
  • Authentication
  • Bearer token authentication method Added
POST /product_drafts/auto_classify
  • Authentication
  • Bearer token authentication method Added
POST /product_drafts/approve
  • Authentication
  • Bearer token authentication method Added
POST /ingredients/create
  • Authentication
  • Bearer token authentication method Added
POST /analyze/ingredient_list
  • Response
  • 200 response Removed
  • 201 response Added
  • Authentication
  • Bearer token authentication method Added
GET /products/{id_or_alias}/analysis
  • Authentication
  • Bearer token authentication method Added
GET /products/{id_or_alias}
  • Authentication
  • Bearer token authentication method Added
GET /products
  • Authentication
  • Bearer token authentication method Added
GET /product_drafts/{id}
  • Authentication
  • Bearer token authentication method Added
GET /product_drafts
  • Authentication
  • Bearer token authentication method Added
GET /product_categories/{id_or_alias}/products
  • Authentication
  • Bearer token authentication method Added
GET /product_categories/{id_or_alias}
  • Authentication
  • Bearer token authentication method Added
GET /product_categories
  • Authentication
  • Bearer token authentication method Added
GET /ingredients/{id_or_alias}/products
  • Authentication
  • Bearer token authentication method Added
GET /ingredients/{id_or_alias}
  • Authentication
  • Bearer token authentication method Added
GET /ingredients
  • Authentication
  • Bearer token authentication method Added
GET /featured
  • Authentication
  • Bearer token authentication method Added
GET /buy/{id_or_alias}/amzn
  • Authentication
  • Bearer token authentication method Added
GET /breadcrumbs/product_category/{id_or_alias}
  • Authentication
  • Bearer token authentication method Added
GET /breadcrumbs/product/{id_or_alias}
  • Authentication
  • Bearer token authentication method Added
GET /brands/{id_or_alias}/products
  • Authentication
  • Bearer token authentication method Added
GET /brands/{id_or_alias}
  • Authentication
  • Bearer token authentication method Added
GET /brands
  • Authentication
  • Bearer token authentication method Added
GET /articles/{id_or_alias}
  • Authentication
  • Bearer token authentication method Added
GET /articles
  • Authentication
  • Bearer token authentication method Added
Added 2
POST /compare/track
GET /analyze/shared/{token}
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 property Modified
    • product_attributes property Modified
GET /product_drafts/{id}
  • Response
  • 200 response Modified
    • reviewer_user_id property Modified
    • product_attributes property 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 property 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 property 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 property Modified
GET /product_categories/{id_or_alias}/products
  • Response
  • 200 response Modified
    • data property Modified
GET /product_drafts
  • Response
  • 200 response Modified
    • id property Modified
    • type, attributes properties Removed
    • author_user_id, reviewer_user_id, product_attributes, ingredient_classifications, draft_version, created_at, updated_at, approved_at properties Added
GET /product_drafts/{id}
  • Response
  • 200 response Modified
    • id property Modified
    • type, attributes properties Removed
    • author_user_id, reviewer_user_id, product_attributes, ingredient_classifications, draft_version, created_at, updated_at, approved_at properties Added
GET /products
  • Response
  • 200 response Modified
    • data property Modified
GET /products/{id_or_alias}
  • Response
  • 200 response Modified
    • data property Modified
4 structure changes including:
3 Additions
1 Modification
Modified 1
GET /product_categories/{id_or_alias}/products
  • Response
  • 200 response Modified
    • data, links properties 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 properties 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