Skin-tech community
This is the documentation for version 1.0.0
of the API. Last update on May 24, 2022.
This API is provided under license Apache, 2.0.
https://staging.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://staging.cosmily.com/api/v1/analyze/ingredient_list \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"ingredients":"string"}'{
"ingredients": "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"
},
"permissions": {
"can_create_product": true
}
}
}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://staging.cosmily.com/api/v1/analyze/claim/{token} \
-H "Authorization: Bearer $ACCESS_TOKEN"{
"result": "claimed",
"share_token": "string",
"owner_user": {
"id": 42,
"username": "string"
},
"permissions": {
"can_create_product": true
}
}successful operation
Bad Request
Authorization information is missing or invalid.
Server Error
curl \
-X GET https://staging.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://staging.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"
}
}Search by resource Name
successful operation
Bad Request
Authorization information is missing or invalid.
Server Error