Bearer token (http)
Send a bearer token
(“JWT” Formatted)
in the Authorization
http header
to authenticate with the API.
Skin-tech community
This is the documentation for version 1.0.0
of the API. Last update on Dec 14, 2022.
This API is provided under license Apache, 2.0.
https://api.cosmily.com/api/v1
Send a bearer token
(“JWT” Formatted)
in the Authorization
http header
to authenticate with the API.
Returns the analysis of an ingredient list
successful operation
Bad Request
Authorization information is missing or invalid.
Unprocessable Entity
Server Error
curl \
-X POST https://api.cosmily.com/api/v1/analyze/ingredient_list \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"ingredients":"string","start_from_uuid":"string","ingredient_group":"string"}'
{
"ingredients": "string",
"start_from_uuid": "string",
"ingredient_group": "string"
}
{
"analysis": {
"total_ingredients": 42,
"ingredients_table": [
{
"alias": "string",
"boolean_properties": {
"acne_fighting": true,
"aha": true,
"alcohol": true,
"allergen": true,
"anti_aging": true,
"antioxidant": true,
"antiseptic": true,
"bad_for_dry_skin": true,
"bad_for_oily_skin": true,
"bad_for_sensitive_skin": true,
"bha": true,
"ceramide": true,
"fragrance": true,
"fungal_acne_feeding": true,
"gluten": true,
"good_for_dry_skin": true,
"good_for_oily_skin": true,
"good_for_sensitive_skin": true,
"healing": true,
"hyaluronic_acid": true,
"moisturising": true,
"niacinamide": true,
"paraben": true,
"peg": true,
"pha": true,
"retinoid": true,
"silicone": true,
"softening": true,
"soothing": true,
"sulfate": true,
"uv_protecting": true,
"vitamin": true,
"whitening": true
},
"categories": "string",
"cir_rating": "string",
"ewg": {
"background": "string",
"data": "string",
"decision": "string",
"max": 42,
"min": 42,
"url": "string"
},
"id": 42,
"index": 42,
"integer_properties": {
"comedogenic_rating": 42,
"natural": 42
},
"introtext": "string",
"title": "string"
}
],
"harmful": {
"alcohol": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"slug": "string",
"title": "string"
},
"allergen": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"slug": "string",
"title": "string"
},
"comedogenic_rating": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"slug": "string",
"title": "string"
},
"fragrance": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"slug": "string",
"title": "string"
},
"fungal_acne_feeding": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"slug": "string",
"title": "string"
},
"gluten": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"slug": "string",
"title": "string"
},
"paraben": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"slug": "string",
"title": "string"
},
"peg": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"slug": "string",
"title": "string"
},
"silicone": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"slug": "string",
"title": "string"
},
"sulfate": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"slug": "string",
"title": "string"
}
},
"positive": {
"acne_fighting": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"anti_aging": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"antioxidant": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"antiseptic": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"healing": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"moisturising": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"softening": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"soothing": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"uv_protecting": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"whitening": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
}
},
"notable": {
"aha": {
"count": 42,
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"antioxidant": {
"count": 42,
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"bha": {
"count": 42,
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"ceramide": {
"count": 42,
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"hyaluronic_acid": {
"count": 42,
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"niacinamide": {
"count": 42,
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"pha": {
"count": 42,
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"retinoid": {
"count": 42,
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"vitamin": {
"count": 42,
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
}
},
"ewg": {
"high": {
"count": 42,
"percent": 42.0
},
"low": {
"count": 42,
"percent": 42.0
},
"moderate": {
"count": 42,
"percent": 42.0
},
"unknown": {
"count": 42,
"percent": 42.0
}
},
"natural": {
"organic": {
"count": 42,
"percent": 42.0
},
"synthetic": {
"count": 42,
"percent": 42.0
},
"unknown": {
"count": 42,
"percent": 42.0
}
},
"text": "string",
"description": "string",
"share_token": "string",
"owner_user": {
"id": 42,
"username": "string"
},
"ingredient_group": "string",
"permissions": {
"can_create_product": true
}
}
}
curl \
-X GET https://api.cosmily.com/api/v1/analyze/ingredient_groups \
-H "Authorization: Bearer $ACCESS_TOKEN"
{
"ingredient_groups": [
"string"
]
}
filter based on ingredient group
curl \
-X GET https://api.cosmily.com/api/v1/analyze/ingredient_group?ingredient_group=string \
-H "Authorization: Bearer $ACCESS_TOKEN"
{
"log_uuid": "string"
}
Marks an unowned ingredient analysis as owned by the logged in user
token reference to desired resource
successful operation
Values are claimed
or nop
.
Bad Request
Authorization information is missing or invalid.
Ingredient Analysis Not Found
Conflict occurred
Unprocessable Entity
Server Error
curl \
-X PATCH https://api.cosmily.com/api/v1/analyze/claim/{token} \
-H "Authorization: Bearer $ACCESS_TOKEN"
{
"result": "claimed",
"share_token": "string",
"owner_user": {
"id": 42,
"username": "string"
},
"ingredient_group": "string",
"permissions": {
"can_create_product": true
}
}
token reference to desired resource
successful operation
Bad Request
Authorization information is missing or invalid.
Shared Ingredient List Analysis Not Found
Server Error
curl \
-X GET https://api.cosmily.com/api/v1/analyze/shared/{token} \
-H "Authorization: Bearer $ACCESS_TOKEN"
{
"analysis": {
"total_ingredients": 42,
"ingredients_table": [
{
"alias": "string",
"boolean_properties": {
"acne_fighting": true,
"aha": true,
"alcohol": true,
"allergen": true,
"anti_aging": true,
"antioxidant": true,
"antiseptic": true,
"bad_for_dry_skin": true,
"bad_for_oily_skin": true,
"bad_for_sensitive_skin": true,
"bha": true,
"ceramide": true,
"fragrance": true,
"fungal_acne_feeding": true,
"gluten": true,
"good_for_dry_skin": true,
"good_for_oily_skin": true,
"good_for_sensitive_skin": true,
"healing": true,
"hyaluronic_acid": true,
"moisturising": true,
"niacinamide": true,
"paraben": true,
"peg": true,
"pha": true,
"retinoid": true,
"silicone": true,
"softening": true,
"soothing": true,
"sulfate": true,
"uv_protecting": true,
"vitamin": true,
"whitening": true
},
"categories": "string",
"cir_rating": "string",
"ewg": {
"background": "string",
"data": "string",
"decision": "string",
"max": 42,
"min": 42,
"url": "string"
},
"id": 42,
"index": 42,
"integer_properties": {
"comedogenic_rating": 42,
"natural": 42
},
"introtext": "string",
"title": "string"
}
],
"harmful": {
"alcohol": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"slug": "string",
"title": "string"
},
"allergen": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"slug": "string",
"title": "string"
},
"comedogenic_rating": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"slug": "string",
"title": "string"
},
"fragrance": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"slug": "string",
"title": "string"
},
"fungal_acne_feeding": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"slug": "string",
"title": "string"
},
"gluten": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"slug": "string",
"title": "string"
},
"paraben": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"slug": "string",
"title": "string"
},
"peg": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"slug": "string",
"title": "string"
},
"silicone": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"slug": "string",
"title": "string"
},
"sulfate": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"slug": "string",
"title": "string"
}
},
"positive": {
"acne_fighting": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"anti_aging": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"antioxidant": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"antiseptic": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"healing": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"moisturising": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"softening": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"soothing": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"uv_protecting": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"whitening": {
"count": 42,
"description": "string",
"image_url": "string",
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
}
},
"notable": {
"aha": {
"count": 42,
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"antioxidant": {
"count": 42,
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"bha": {
"count": 42,
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"ceramide": {
"count": 42,
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"hyaluronic_acid": {
"count": 42,
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"niacinamide": {
"count": 42,
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"pha": {
"count": 42,
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"retinoid": {
"count": 42,
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
},
"vitamin": {
"count": 42,
"list": [
{
"index": 42,
"title": "string",
"alias": "string"
}
],
"title": "string"
}
},
"ewg": {
"high": {
"count": 42,
"percent": 42.0
},
"low": {
"count": 42,
"percent": 42.0
},
"moderate": {
"count": 42,
"percent": 42.0
},
"unknown": {
"count": 42,
"percent": 42.0
}
},
"natural": {
"organic": {
"count": 42,
"percent": 42.0
},
"synthetic": {
"count": 42,
"percent": 42.0
},
"unknown": {
"count": 42,
"percent": 42.0
}
},
"text": "string",
"description": "string",
"share_token": "string",
"owner_user": {
"id": 42,
"username": "string"
},
"ingredient_group": "string",
"permissions": {
"can_create_product": true
}
}
}
Returns feelings for each ingredient with feelings
token reference to desired resource
successful operation
Values are positive
or negative
.
Bad Request
Authorization information is missing or invalid.
Ingredient List Analysis Not Found
Server Error
curl \
-X GET https://api.cosmily.com/api/v1/analyze/{token}/ingredient_feelings \
-H "Authorization: Bearer $ACCESS_TOKEN"
{
"data": [
{
"id": 42,
"active": true,
"feeling_type": "positive",
"created_at": "string",
"updated_at": "string",
"ingredient_id": 42,
"author_user_id": 42,
"author_user": {
"id": 42,
"username": "string",
"user_type": "string",
"last_active": "string"
}
}
]
}
Infers the product category of an ingredient analysis
token reference to desired resource
successful operation
Values are cleanser
, toner
, serum
, moisturizer
, or spf
.
Bad Request
Authorization information is missing or invalid.
Ingredient List Analysis Not Found
Failed to infer product category
Value is unknown
.
Server Error
curl \
-X GET https://api.cosmily.com/api/v1/analyze/{token}/categorize \
-H "Authorization: Bearer $ACCESS_TOKEN"
{
"category": "cleanser"
}
{
"error": "unknown"
}
Returns missing ingredients for analyze token
token reference to desired resource
curl \
-X GET https://api.cosmily.com/api/v1/analyze/{token}/missing_ingredients \
-H "Authorization: Bearer $ACCESS_TOKEN"
[
"string"
]
Runs a personalized ruleset on the ingredient analysis
token reference to desired resource
Values are cleanser
, toner
, serum
, moisturizer
, or spf
.
Values are AM
, PM
, or BOTH
. Default value is BOTH
.
curl \
-X GET https://api.cosmily.com/api/v1/analyze/{token}/personalize \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"category":"cleanser","timeslot":"BOTH","am_routine_id":42,"pm_routine_id":42}'
{
"category": "cleanser",
"timeslot": "BOTH",
"am_routine_id": 42,
"pm_routine_id": 42
}
{
"failing_rules": {
"preference": [
{
"rule": [
"string"
],
"message": "string"
}
],
"safety": [
{
"rule": [
"string"
],
"message": "string"
}
],
"product": [
{
"rule": [
"string"
],
"message": "string"
}
],
"routine": [
{
"rule": [
"string"
],
"message": "string"
}
]
}
}
token reference to desired resource
successful operation
Bad Request
Authorization information is missing or invalid.
Ingredient List Analysis Not Found
Unprocessable Entity
Server Error
curl \
-X GET https://api.cosmily.com/api/v1/analyze/{token}/skin_calc \
-H "Authorization: Bearer $ACCESS_TOKEN"
{
"data": {
"ingredients": {
"bad_aliases": [
{
"alias": "string",
"supergroup": "string",
"reason": "string"
}
],
"good_aliases": [
{
"alias": "string",
"supergroup": "string",
"reason": "string"
}
]
},
"rules": [
{
"type": "string",
"category": "string",
"message": "string"
}
]
}
}
token reference to desired resource
rules based on category
Values are cleanser
, toner
, serum
, moisturizer
, spf
, or other
.
rules based on time of day
Values are AM
, PM
, or BOTH
. Default value is BOTH
.
rules based on is_living_hot_summer
rules based on is_living_cold_winter
rules based on is_living_dry_climate
rules based on is_living_urban_area
rules based on is_constrained_budget
rules based on is_constrained_time
rules based on is_high_sun_exposure
rules based on is_concerned_parabens
Default value is true
.
rules based on is_concerned_sulfates
Default value is true
.
rules based on is_concerned_silicones
Default value is true
.
rules based on is_concerned_gluten
rules based on is_condition_acne
rules based on is_condition_eczema
rules based on is_condition_rosacea
rules based on is_condition_dehydration
rules based on rating_persona_oily
Values are 0
, 1
, 2
, 3
, 4
, or 5
.
rules based on rating_persona_sensitive
Values are 0
, 1
, 2
, 3
, 4
, or 5
.
rules based on rating_persona_uneven
Values are 0
, 1
, 2
, 3
, 4
, or 5
.
rules based on rating_persona_wrinkled
Values are 0
, 1
, 2
, 3
, 4
, or 5
.
successful operation
Bad Request
Authorization information is missing or invalid.
Ingredient List Analysis Not Found
Failed to infer product category
Value is unknown
.
Server Error
curl \
-X GET https://api.cosmily.com/api/v1/analyze/{token}/rules?category=cleanser&rating_persona_oily=0&rating_persona_sensitive=0&rating_persona_uneven=0&rating_persona_wrinkled=0 \
-H "Authorization: Bearer $ACCESS_TOKEN"
{
"data": {
"bad_ingredients": {
"reason": "string",
"ingredient": {
"id": 42,
"title": "string",
"alias": "string"
},
"explanation": "string"
},
"is_good_for_you": true,
"failed_product_rules": [
{
"explanation": "string",
"identifier": "string",
"label": "string"
}
],
"suggestion": {
"explanations": [
"string"
],
"products": [
{
"id": 42,
"title": "string",
"alias": "string"
}
]
}
}
}
{
"error": "unknown"
}
Returns products similar to the ingredient list analysis
token reference to desired resource
successful operation
Bad Request
Authorization information is missing or invalid.
Ingredient List Analysis Not Found
Unprocessable Entity
Server Error
curl \
-X GET https://api.cosmily.com/api/v1/analyze/{token}/similar_products \
-H "Authorization: Bearer $ACCESS_TOKEN"
{
"similar": [
{
"product_id": 42,
"category_id": 42,
"score": 42,
"percent_match": 42
}
]
}
Returns the positive, harmful, and notable effects for the submitted list of ingredients
successful operation
Bad Request
Authorization information is missing or invalid.
Requested resource not found
Unprocessable Entity
Server Error
curl \
-X POST https://api.cosmily.com/api/v1/analyze/effects \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"ingredient_ids":[42]}'
{
"ingredient_ids": [
42
]
}
{
"effects": {
"positive": [
{
"effect": "string",
"ingredient_ids": [
42
]
}
],
"harmful": [
{
"effect": "string",
"ingredient_ids": [
42
]
}
],
"notable": [
{
"effect": "string",
"ingredient_ids": [
42
]
}
]
},
"supported": {
"positive": [],
"harmful": [],
"notable": []
}
}
Extracts a label (list of ingredients) from an arbitrary text block
curl \
-X POST https://api.cosmily.com/api/v1/analyze/extract_label \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"input_text":"string"}'
{
"input_text": "string"
}
{
"label": [
"string"
]
}
successful operation
Bad Request
Authorization information is missing or invalid.
Server Error
curl \
-X GET https://api.cosmily.com/api/v1/articles \
-H "Authorization: Bearer $ACCESS_TOKEN"
{
"data": [
{
"id": 1,
"alias": "cosrx-aha-bha-clarifying-treatment-toner-review-1",
"title": "COSRX AHA/BHA Clarifying Treatment Toner Review",
"description": "Hello! Today I'm going to review a COSRX AHA/BHA Clarifying Treatment Toner manufactured by famous Korean brand COSRX. I've been regularly using this product for more than a month and I have a lot to share with you. Make sure you have read this",
"content": "<p>Hello! Today I'm going to review a <strong>COSRX AHA/BHA Clarifying Treatment Toner</strong> manufactured by famous Korean brand <strong><a href=\"/brands/cosrx\">COSRX</a></strong>. I've been regularly using this product for more than a month and I have a lot to share with you.Make sure you have read this article till the end because the most important information is there.</p> <p>The toner is made for <strong>removing dead skin cells</strong> and for <strong>increasing skin flexibility</strong>. The product contains mineral water, natural AHA (Pyrus Malus Apple Fruit Water 10%), natural BHA and some additional stuff like allantoin to moisturize the skin and make it smoother. The manufacturer reports that it allows you to prevent whiteheads and blackheads, so if you have such problems this toner is worth trying.</p> <p><b>Here is a full list of active Ingredients:</b> Mineral Water, Salix Alba (Willow) Bark Water, Pyrus Malus (Apple) Fruit Water, Butylene Glycol, 1,2-Hexanediol, Sodium Lactate, Glycolic Acid, Water, Betaine Salicylate, Allantoin, Panthenol, Ethyl Hexanediol. </p><p>As you see the list is very short: only 12 ingredients and most of them are natural. The main goal of a company is to produce high-quality products using zero harmful ingredients and a large number of good components.</p> <p>The price varies from 10 USD to 15 USD depending on the seller. Some sellers offer to buy several toners at once but the price doesn’t seem to be lower. Visit Amazon to see actual prices. As you see the price is really low and it’s a perfect opportunity to try AHA/BHA product at a very cheap price.</p><p><img src=\"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAQ8B0mBNpGO7V7V6D9DU1adPAAABHSA0gNIDSA0gNIEgI6QGkCQACOkBpAAD//Z\"><br></p> <p></p> <p><strong>The package doesn’t look expensive. </strong>It’s an ordinary box without any special drawing. The bottle and the sprayer look standard. COSRX tradition is to make products with a minimalistic design. That’s cheaper and allows the company to lower the price. Fortunately, this doesn’t affect the quality. Personally, I don’t care about the package. But I really care about what’s inside.</p> <p></p> <p>Though the bottle and sprayer look simple, <strong>they work great</strong> and to their job as they should. The nozzle sprays out a fine portion of toner and I like how it works.</p> <p>But a slight problem may occur at the end of its life: there may be some toner left at the bottom and you will have to open the bottle because sprayer will not be able to take everything out. This is a standard problem of many sprayers. </p> <h2>How to use it?</h2> <p>The usage process is simple: apply some toner to your face and massage the skin with a cotton pad. The matter feels very watery. That’s not a big surprise: just return and see what it is made off. The number one ingredient is mineral water…</p> <p>Some people recommend applying the toner to the cotton pad and then massage the skin with it. But I don’t recommend doing this. If you use it with a cotton pad you will spend much more productive than if you just spray it on the face and use the pad after this.</p> <p>But you need to use a cotton pad to remove dead skin anyway. If you don’t remove dead skin, you may see less results from using it.</p> <p>The pH level is low: only 3.9. The normal pH of the human’s skin is 5.5, but despite this, the product feels very good.</p> <p><strong>You can use it twice a day</strong>, in the morning after you wash your face and in the evening. The product is gentle enough and will not irritate your skin. But be careful if you wish using it twice. Your skin may be sensitive to one or more things in this toner. So it’s better to test it in the beginning. Start using it once a day and if everything is ok and your skin feels good to try using it twice.</p> <h2>My Personal Experience with this Treatment Toner</h2> <p>AHA BHA Clarifying Treatment Toner won't be giving you too much of a visible result if your skin is already used to stronger exfoliants. But you may see a good result if you are a beginner in exfoliation with acids.</p> <p>If I want to use BHA at night or in the morning I use this one because I know for a fact that this exfoliator is mild. I also like to use it on my body because it's very refreshing after a workout.</p> <p><b>As for the effectiveness: I didn’t see too much result from this single product, but it’s a good toner to use in a combination with other skincare stuff.</b> I don’t expect great effectiveness from a single toner. But what it really does is it moisturizes the skin and helps to prepare it for the products I use later. How? Because it <strong>temporarily lowers the pH level of the skin</strong>. Lower skin pH allows the acids/actives of the stuff I use later to stay in unchanged form. And this results in better absorption because unchanged acids can pass through the skin deeper.</p> <p>That’s why I absolutely recommend using this toner at the beginning of your self-care routine. This will prepare your skin for further products and make the entire routine much more effective.</p> <p>Thanks for reading my review! I hope you have found a lot of useful information in it. I have also prepared answers to some very popular questions about this product.</p> <p><strong>Q: Does this toner require using a sunscreen after it?</strong></p> <p>A: Yes, it does. It contains AHA which makes your skin a little bit more sensitive to the sun. The effect is not strong, but if your skin is sun-sensitive it’s recommended using a sunscreen.</p> <p><strong>Q: Does it remove whiteheads and blackheads?</strong></p> <p>A: This product doesn’t remove whiteheads and blackheads on its own. It’s better to use it in a combination with other products. But manufacturers report it can prevent whiteheads and blackheads if you use it regularly.</p>",
"author_user_id": 1,
"created_at": "2021-10-04T13:24:22.000Z",
"updated_at": "2021-11-13T20:23:18.000Z"
}
],
"links": {
"first": "/api/v1/articles?page=1",
"last": "/api/v1/articles?page=1"
}
}
ID of the resource to return
successful operation
Bad Request
Authorization information is missing or invalid.
Article not found
Server Error
curl \
-X GET https://api.cosmily.com/api/v1/articles/{id_or_alias} \
-H "Authorization: Bearer $ACCESS_TOKEN"
{
"data": {
"id": 1,
"alias": "cosrx-aha-bha-clarifying-treatment-toner-review-1",
"title": "COSRX AHA/BHA Clarifying Treatment Toner Review",
"description": "Hello! Today I'm going to review a COSRX AHA/BHA Clarifying Treatment Toner manufactured by famous Korean brand COSRX. I've been regularly using this product for more than a month and I have a lot to share with you.Make sure you have read this",
"content": "<p>Hello! Today I'm going to review a <strong>COSRX AHA/BHA Clarifying Treatment Toner</strong> manufactured by famous Korean brand <strong><a href=\"/brands/cosrx\">COSRX</a></strong>. I've been regularly using this product for more than a month and I have a lot to share with you.Make sure you have read this article till the end because the most important information is there.</p> <p>The toner is made for <strong>removing dead skin cells</strong> and for <strong>increasing skin flexibility</strong>. The product contains mineral water, natural AHA (Pyrus Malus Apple Fruit Water 10%), natural BHA and some additional stuff like allantoin to moisturize the skin and make it smoother. The manufacturer reports that it allows you to prevent whiteheads and blackheads, so if you have such problems this toner is worth trying.</p> <p><b>Here is a full list of active Ingredients:</b> Mineral Water, Salix Alba (Willow) Bark Water, Pyrus Malus (Apple) Fruit Water, Butylene Glycol, 1,2-Hexanediol, Sodium Lactate, Glycolic Acid, Water, Betaine Salicylate, Allantoin, Panthenol, Ethyl Hexanediol. </p><p>As you see the list is very short: only 12 ingredients and most of them are natural. The main goal of a company is to produce high-quality products using zero harmful ingredients and a large number of good components.</p> <p>The price varies from 10 USD to 15 USD depending on the seller. Some sellers offer to buy several toners at once but the price doesn’t seem to be lower. Visit Amazon to see actual prices. As you see the price is really low and it’s a perfect opportunity to try AHA/BHA product at a very cheap price.</p><p><img src=\"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAQ8B0mBNpGO7V7V6D9DU1adPAAABHSA0gNIDSA0gNIEgI6QGkCQACOkBpAAD//Z\"><br></p> <p></p> <p><strong>The package doesn’t look expensive. </strong>It’s an ordinary box without any special drawing. The bottle and the sprayer look standard. COSRX tradition is to make products with a minimalistic design. That’s cheaper and allows the company to lower the price. Fortunately, this doesn’t affect the quality. Personally, I don’t care about the package. But I really care about what’s inside.</p> <p></p> <p>Though the bottle and sprayer look simple, <strong>they work great</strong> and to their job as they should. The nozzle sprays out a fine portion of toner and I like how it works.</p> <p>But a slight problem may occur at the end of its life: there may be some toner left at the bottom and you will have to open the bottle because sprayer will not be able to take everything out. This is a standard problem of many sprayers. </p> <h2>How to use it?</h2> <p>The usage process is simple: apply some toner to your face and massage the skin with a cotton pad. The matter feels very watery. That’s not a big surprise: just return and see what it is made off. The number one ingredient is mineral water…</p> <p>Some people recommend applying the toner to the cotton pad and then massage the skin with it. But I don’t recommend doing this. If you use it with a cotton pad you will spend much more productive than if you just spray it on the face and use the pad after this.</p> <p>But you need to use a cotton pad to remove dead skin anyway. If you don’t remove dead skin, you may see less results from using it.</p> <p>The pH level is low: only 3.9. The normal pH of the human’s skin is 5.5, but despite this, the product feels very good.</p> <p><strong>You can use it twice a day</strong>, in the morning after you wash your face and in the evening. The product is gentle enough and will not irritate your skin. But be careful if you wish using it twice. Your skin may be sensitive to one or more things in this toner. So it’s better to test it in the beginning. Start using it once a day and if everything is ok and your skin feels good to try using it twice.</p> <h2>My Personal Experience with this Treatment Toner</h2> <p>AHA BHA Clarifying Treatment Toner won't be giving you too much of a visible result if your skin is already used to stronger exfoliants. But you may see a good result if you are a beginner in exfoliation with acids.</p> <p>If I want to use BHA at night or in the morning I use this one because I know for a fact that this exfoliator is mild. I also like to use it on my body because it's very refreshing after a workout.</p> <p><b>As for the effectiveness: I didn’t see too much result from this single product, but it’s a good toner to use in a combination with other skincare stuff.</b> I don’t expect great effectiveness from a single toner. But what it really does is it moisturizes the skin and helps to prepare it for the products I use later. How? Because it <strong>temporarily lowers the pH level of the skin</strong>. Lower skin pH allows the acids/actives of the stuff I use later to stay in unchanged form. And this results in better absorption because unchanged acids can pass through the skin deeper.</p> <p>That’s why I absolutely recommend using this toner at the beginning of your self-care routine. This will prepare your skin for further products and make the entire routine much more effective.</p> <p>Thanks for reading my review! I hope you have found a lot of useful information in it. I have also prepared answers to some very popular questions about this product.</p> <p><strong>Q: Does this toner require using a sunscreen after it?</strong></p> <p>A: Yes, it does. It contains AHA which makes your skin a little bit more sensitive to the sun. The effect is not strong, but if your skin is sun-sensitive it’s recommended using a sunscreen.</p> <p><strong>Q: Does it remove whiteheads and blackheads?</strong></p> <p>A: This product doesn’t remove whiteheads and blackheads on its own. It’s better to use it in a combination with other products. But manufacturers report it can prevent whiteheads and blackheads if you use it regularly.</p>",
"author": {
"id": 1,
"username": "admin",
"last_active": "2021-10-04T13:24:22.000Z"
},
"created_at": "2021-10-04T13:24:22.000Z",
"updated_at": "2021-11-13T20:23:18.000Z"
}
}
successful operation
Bad Request
Authorization information is missing or invalid.
Server Error
curl \
-X GET https://api.cosmily.com/api/v1/brands \
-H "Authorization: Bearer $ACCESS_TOKEN"
{
"data": [
{
"id": 111,
"alias": "pasjel",
"title": "PasJel",
"product_count": 243,
"created_at": "2021-10-04T13:24:22.000Z",
"updated_at": "2021-11-13T20:23:18.000Z",
"owner": {
"id": 222,
"username": "pasjel_cosmily",
"user_type": "brand",
"last_active": "2022--2-09T21:22:23.000Z"
}
}
],
"links": {
"first": "/api/v1/brands?page=1",
"last": "/api/v1/brands?page=1"
}
}
ID of the resource to return
successful operation
Bad Request
Authorization information is missing or invalid.
Brand Not Found
Server Error
curl \
-X GET https://api.cosmily.com/api/v1/brands/{id_or_alias} \
-H "Authorization: Bearer $ACCESS_TOKEN"
{
"data": {
"id": 111,
"alias": "pasjel",
"title": "PasJel",
"owner": {
"id": 222,
"username": "pasjel_cosmily",
"user_type": "brand",
"last_active": "2021-10-04T13:24:22.000Z"
},
"created_at": "2021-10-04T13:24:22.000Z",
"updated_at": "2021-11-13T20:23:18.000Z"
}
}
ID of the resource to return
successful operation
Bad Request
Authorization information is missing or invalid.
Brand Not Found
Server Error
curl \
-X PATCH https://api.cosmily.com/api/v1/brands/{id_or_alias} \
-H "Authorization: Bearer $ACCESS_TOKEN"
{
"data": {
"id": 1,
"alias": "pasjel",
"title": "PasJel",
"owner": {
"id": 1,
"username": "admin",
"last_active": "2021-10-04T13:24:22.000Z"
},
"created_at": "2021-10-04T13:24:22.000Z",
"updated_at": "2021-11-13T20:23:18.000Z"
}
}
Returns products for a particular brand via the brandId
ID of the resource to return
Search by Feature Non-Comedogenic
Search by Feature Allergen Free
Search by Feature Alcohol Free
Search by Feature Gluten Free
Search by Feature Silicone Free
Search by Feature Sulfate Free
Search by Feature Paraben Free
Search by Feature PEG Free
Search by Feature Fungal Acne Feeding Free
Search by Feature Fragrance Free
Search by Feature Moisturising
Search by Feature Softening
Search by Feature Soothing
Search by Feature Acne Fighting
Search by Feature Anti-Aging
Search by Feature Healing
Search by Feature Antiseptic
Search by Feature Brightening
Search by Feature UV Protecting
Search by Feature Antioxidant
successful operation
Bad Request
Authorization information is missing or invalid.
Requested Products For This Brand Not Found
Server Error
curl \
-X GET https://api.cosmily.com/api/v1/brands/{id_or_alias}/products \
-H "Authorization: Bearer $ACCESS_TOKEN"
{
"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"
}
}
Transfers ownership of a brand
ID of the resource to return
successful operation
Bad Request
Authorization information is missing or invalid.
Brand Not Found
Server Error
curl \
-X PATCH https://api.cosmily.com/api/v1/brands/{id_or_alias}/transfer_ownership \
-H "Authorization: Bearer $ACCESS_TOKEN"
{
"data": {
"id": 1,
"alias": "pasjel",
"title": "PasJel",
"owner": {
"id": 1,
"username": "admin",
"last_active": "2021-10-04T13:24:22.000Z"
},
"created_at": "2021-10-04T13:24:22.000Z",
"updated_at": "2021-11-13T20:23:18.000Z"
}
}
Return all breadcrumbs available for a specific product category
ID of the resource to return
curl \
-X GET https://api.cosmily.com/api/v1/breadcrumbs/product_category/{id_or_alias} \
-H "Authorization: Bearer $ACCESS_TOKEN"