{"openapi":"3.1.0","info":{"title":"Cosmetics & Beauty API","version":"1.0.0","description":"The open cosmetics and personal-care product database — Open Beauty Facts — as an API. Look up any cosmetic or personal-care product by its barcode to get its name and brand, full INCI ingredient list and ingredient count, categories and labels, quantity, the period-after-opening (the \"12M\" open-jar symbol), origin countries, a product image, and a vegan / palm-oil-free analysis derived from its ingredients; search the database by keyword; and browse products by category (shampoos, lipsticks, deodorants, sunscreens, moisturisers and more). Covers shampoos, skincare, make-up, deodorants, toothpaste and other personal-care items from a global, contributor-maintained database. Live from world.openbeautyfacts.org — the cosmetics sister project of Open Food Facts. Ideal for skincare and cosmetics apps, ingredient and allergen checkers, ethical-shopping and sustainability tools. Open data.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/beauty-api","description":"oanor gateway"}],"tags":[{"name":"Beauty"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/category":{"get":{"operationId":"get_v1_category","tags":["Beauty"],"summary":"Browse a product category","description":"","parameters":[{"name":"tag","in":"query","required":true,"description":"Category tag, e.g. shampoos, lipsticks, deodorants","schema":{"type":"string"},"example":"shampoos"},{"name":"limit","in":"query","required":false,"description":"Results (1-50, default 20)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"total":1674,"results":[{"name":"Vichy Dercos Anti-Dandruff Kepek Karşıtı Şampuan 390 ml - Normal ve Yağlı Saçlar","brands":["Vichy"],"barcode":"8690595028064","obf_url":"https://world.openbeautyfacts.org/product/8690595028064","image_url":"https://images.openbeautyfacts.org/images/products/869/059/502/8064/front_tr.3.400.jpg"},{"name":"Shampoing solide Acorn","brands":["Jil Doğal"],"barcode":"8683143845435","obf_url":"https://world.openbeautyfacts.org/product/8683143845435","image_url":"https://images.openbeautyfacts.org/images/products/868/314/384/5435/front_fr.3.400.jpg"},{"name":"Dengeleyici Katı Şampuan / Yağlı Saçlar","brands":["Polente Natural"],"barcode":"8684000493318","obf_url":"https://world.openbeautyfacts.org/product/8684000493318","image_url":"https://images.openbeautyfacts.org/images/products/868/400/049/3318/front_fr.4.400.jpg"},{"brands":[],"barcode":"8699708260216","obf_url":"https://world.openbeautyfacts.org/product/8699708260216"},{"name":"Shampoing nutrition Ultra Doux Argan et camélia","brands":["L'Oréal","L'Oreal Consumer products","Garnier"],"barcode":"3600542525664","obf_url":"https://world.openbeautyfacts.org/product/3600542525664"},{"name":"Shampoing nutrition Ultra Doux Avocat et Karité","brands":["L'Oréal","L'Oreal Consumer products","Garnier"],"barcode":"3600542571951","obf_url":"https://world.openbeautyfacts.org/product/3600542571951","image_url":"https://images.openbeautyfacts.org/images/products/360/054/257/1951/front_fr.8.400.jpg"},{"name":"Shampoing Réhydratant pour Cheveux déshydratés Hyaluron Repulp","brands":["L'Oréal","L'Oreal Consumer products","L'Oréal Paris","Elseve"],"barcode":"0360052414409","obf_url":"https://world.openbeautyfacts.org/product/0360052414409"},{"name":"Shampoing","brands":["Head & Shoulders"],"barcode":"8006540900147","obf_url":"https://world.openbeautyfacts.org/product/8006540900147"},{"brands":[],"barcode":"30158078","obf_url":"https://world.openbeautyfacts.org/product/30158078"},{"name":"ogx argan","brands":["OGX"],"barcode":"0022796976116","obf_url":"https://world.openbeautyfacts.org/product/0022796976116","image_url":"https://images.openbeautyfacts.org/images/products/002/279/697/6116/front_fr.19.400.jpg"},{"name":"Shampooing crème nutrition miel de provence et karité bio","brands":["Le Petit Marseillais"],"barcode":"3574661574561","obf_url":"https://world.openbeautyfacts.org/product/3574661574561","image_url":"https://images.openbeautyfacts.org/images/products/357/466/157/4561/front_fr.3.400.jpg"},{"name":"aloe vera","brands":["shampoo"],"barcode":"5765228838037","obf_url":"https://world.openbeautyfacts.org/product/5765228838037","image_url":"https://images.openbeautyfacts.org/images/products/576/522/883/8037/front_en.4.400.jpg"},{"name":"head&shoulders","brands":[],"barcode":"8001090965721","obf_url":"https://world.openbeautyfacts.org/product/8001090965721","image_url":"https://images.openbeautyfacts.org/images/products/800/109/096/5721/front_fr.12.400.jpg"},{"name":"cadum","brands":["cadum"],"barcode":"6111056012986","obf_url":"https://world.openbeautyfacts.org/product/6111056012986","image_url":"https://images.openbeautyfacts.org/images/products/611/105/601/2986/front_ar.28.400.jpg"},{"name":"Schauma","brands":[],"barcode":"4015100864977","obf_url":"https://world.openbeautyfacts.org/product/4015100864977","image_url":"https://images.openbeautyfacts.org/images/products/401/510/086/4977/front_fr.3.400.jpg"},{"name":"Diane perfect beauty dry shampoo","brands":["Diane"],"barcode":"4560119229380","obf_url":"https://world.openbeautyfacts.org/product/4560119229380"},{"brands":["dm Alverde"],"barcode":"4066447107371","obf_url":"https://world.openbeautyfacts.org/product/4066447107371","image_url":"https://images.openbeautyfacts.org/images/products/406/644/710/7371/front_de.3.400.jpg"},{"name":"Loreal Paris Hyaluron Moisture","brands":["Loreal Paris"],"barcode":"8901526603442","obf_url":"https://world.openbeautyfacts.org/product/8901526603442","image_url":"https://images.openbeautyfacts.org/images/products/890/152/660/3442/front_en.5.400.jpg"},{"brands":["Near"],"barcode":"8017596114570","obf_url":"https://world.openbeautyfacts.org/product/8017596114570","image_url":"https://images.openbeautyfacts.org/images/products/801/759/611/4570/front_it.3.400.jpg"},{"name":"Captain Scent of Fierce Ocean","brands":["Old Spice"],"barcode":"8006530139403","obf_url":"https://world.openbeautyfacts.org/product/8006530139403","image_url":"https://images.openbeautyfacts.org/images/products/800/653/013/9403/front_de.3.400.jpg"}],"category":"shampoos"},"meta":{"timestamp":"2026-05-31T15:22:25.665Z","request_id":"950fc8ab-d406-4586-8881-ba9744c08762"},"status":"ok","message":"Category retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/product":{"get":{"operationId":"get_v1_product","tags":["Beauty"],"summary":"Product by barcode","description":"","parameters":[{"name":"barcode","in":"query","required":true,"description":"Product barcode (EAN/UPC), e.g. 8001090662231","schema":{"type":"string"},"example":"8001090662231"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"product":{"name":"Coconut Milk","brands":["Herbal Essences"],"labels":[],"barcode":"8001090662231","obf_url":"https://world.openbeautyfacts.org/product/8001090662231","analysis":{"tags":["palm-oil-free","vegan-status-unknown","vegetarian-status-unknown"],"palm_oil_free":true},"quantity":"400 ml","countries":[],"image_url":"https://images.openbeautyfacts.org/images/products/800/109/066/2231/front_fr.11.400.jpg","categories":[],"ingredients_text":"Aqua, Sodium Laureth Sulfate, Cocamidopropyl Betaine, Sodium Lauryl Sulfate, Sodium Citrate, Sodium Chloride, Sodium Xylenesulfonate, Stearyl Alcohol, Parfum, Cetyl Alcohol, Glycerin, Glycol Distearate, Dimethiconol, Citric Acid, Sodium Benzoate, Dimethicone, Guar Hydroxypropyltrimonium Chloride, Hexyl Cinnamal, Tetrasodium EDTA, Sodium Hydroxide, TEA-Dodecylbenzenesulfonate, Polyquaternium-6, Trihydroxystearin, Trideceth-10, Histidine, Benzyl Salicylate, Propylene Glycol, Limonene, Linalool, Butylene Glycol, Magnesium Nitrate, Aloe Barbadensis Leaf Juice, Alcohol Denat., Zea Mays Silk Extract, Cocos Nucifera Fruit Extract, Methylchloroisothiazolinone, Magnesium Chloride, Triethylene Glycol, Benzyl Alcohol, Methylisothiazolinone, Ecklonia Radiata Extract","ingredients_count":41}},"meta":{"timestamp":"2026-05-31T15:22:25.770Z","request_id":"9eb024d6-5894-434a-a43c-8735862c89bf"},"status":"ok","message":"Product retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Beauty"],"summary":"Search products","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search term","schema":{"type":"string"},"example":"shampoo"},{"name":"limit","in":"query","required":false,"description":"Results (1-50, default 20)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"query":"shampoo","total":"2164","results":[{"name":"Coconut Milk","brands":["Herbal Essences"],"barcode":"8001090662231","obf_url":"https://world.openbeautyfacts.org/product/8001090662231","image_url":"https://images.openbeautyfacts.org/images/products/800/109/066/2231/front_fr.11.400.jpg"},{"name":"SHAMPOO","brands":[],"barcode":"8001090662057","obf_url":"https://world.openbeautyfacts.org/product/8001090662057","image_url":"https://images.openbeautyfacts.org/images/products/800/109/066/2057/front_en.22.400.jpg"},{"name":"johnsons","brands":["shampo"],"barcode":"3574669907842","obf_url":"https://world.openbeautyfacts.org/product/3574669907842","image_url":"https://images.openbeautyfacts.org/images/products/357/466/990/7842/front_fr.3.400.jpg"},{"name":"Johnsons","brands":["Johnsons"],"barcode":"6223000659243","obf_url":"https://world.openbeautyfacts.org/product/6223000659243","image_url":"https://images.openbeautyfacts.org/images/products/622/300/065/9243/front_fr.3.400.jpg"},{"brands":[],"barcode":"5011321362406","obf_url":"https://world.openbeautyfacts.org/product/5011321362406","image_url":"https://images.openbeautyfacts.org/images/products/501/132/136/2406/front_en.11.400.jpg"},{"brands":["Pantene"],"barcode":"4084500526792","obf_url":"https://world.openbeautyfacts.org/product/4084500526792","image_url":"https://images.openbeautyfacts.org/images/products/408/450/052/6792/front_ar.5.400.jpg"},{"name":"Argan oil shampoo","brands":["Deliplus"],"barcode":"8480000443373","obf_url":"https://world.openbeautyfacts.org/product/8480000443373","image_url":"https://images.openbeautyfacts.org/images/products/848/000/044/3373/front_en.24.400.jpg"},{"name":"Anti dandruff shampoo","brands":["Dercos"],"barcode":"3337871330262","obf_url":"https://world.openbeautyfacts.org/product/3337871330262","image_url":"https://images.openbeautyfacts.org/images/products/333/787/133/0262/front_fr.3.400.jpg"},{"name":"Vitaïa","brands":[],"barcode":"6111242926486","obf_url":"https://world.openbeautyfacts.org/product/6111242926486","image_url":"https://images.openbeautyfacts.org/images/products/611/124/292/6486/front_en.25.400.jpg"},{"name":"Golden Moringa Oil Shampoo","brands":["Herbal Essences"],"barcode":"8001090661999","obf_url":"https://world.openbeautyfacts.org/product/8001090661999","image_url":"https://images.openbeautyfacts.org/images/products/800/109/066/1999/front_fr.8.400.jpg"},{"name":"ultra doux shampoo","brands":["L'Oréal","L'Oreal Consumer products","Garnier"],"barcode":"3610340634185","obf_url":"https://world.openbeautyfacts.org/product/3610340634185","image_url":"https://images.openbeautyfacts.org/images/products/361/034/063/4185/front_en.4.400.jpg"},{"name":"shampoo","brands":["clear"],"barcode":"6221155058522","obf_url":"https://world.openbeautyfacts.org/product/6221155058522","image_url":"https://images.openbeautyfacts.org/images/products/622/115/505/8522/front_en.20.400.jpg"},{"name":"Shampoo","brands":["Deliplus","Mercadona"],"barcode":"8402001006029","obf_url":"https://world.openbeautyfacts.org/product/8402001006029","image_url":"https://images.openbeautyfacts.org/images/products/840/200/100/6029/front_ar.11.400.jpg"},{"name":"Anti Dandruff Shampoo Deep Clean Severe Oily Scalp","brands":["Head&shoulders"],"barcode":"8001090967558","obf_url":"https://world.openbeautyfacts.org/product/8001090967558","image_url":"https://images.openbeautyfacts.org/images/products/800/109/096/7558/front_en.8.400.jpg"},{"brands":["L'Oréal"],"barcode":"3610340655227","obf_url":"https://world.openbeautyfacts.org/product/3610340655227","image_url":"https://images.openbeautyfacts.org/images/products/361/034/065/5227/front_en.11.400.jpg"},{"name":"Stimulating shampoo","brands":["Dercos"],"barcode":"3337871311292","obf_url":"https://world.openbeautyfacts.org/product/3337871311292","image_url":"https://images.openbeautyfacts.org/images/products/333/787/131/1292/front_fr.16.400.jpg"},{"name":"head&shoulders","brands":[],"barcode":"8001090965721","obf_url":"https://world.openbeautyfacts.org/product/8001090965721","image_url":"https://images.openbeautyfacts.org/images/products/800/109/096/5721/front_fr.12.400.jpg"},{"name":"garnier","brands":["L'Oréal","L'Oreal Consumer products","Garnier"],"barcode":"3600542370110","obf_url":"https://world.openbeautyfacts.org/product/3600542370110","image_url":"https://images.openbeautyfacts.org/images/products/360/054/237/0110/front_fr.16.400.jpg"},{"name":"Shampoo natural","brands":["Deliplus","Mercadona"],"barcode":"8480000443359","obf_url":"https://world.openbeautyfacts.org/product/8480000443359","image_url":"https://images.openbeautyfacts.org/images/products/848/000/044/3359/front_en.14.400.jpg"},{"brands":["head &sholders"],"barcode":"5000174463217","obf_url":"https://world.openbeautyfacts.org/product/5000174463217","image_url":"https://images.openbeautyfacts.org/images/products/500/017/446/3217/front_en.19.400.jpg"}]},"meta":{"timestamp":"2026-05-31T15:22:25.972Z","request_id":"1b20fd81-5285-4253-8780-825cf8676507"},"status":"ok","message":"Products searched","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Source & options","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Cosmetics & personal-care products. /v1/product = look up by barcode (name, brand, INCI ingredients, categories, labels, period-after-opening, vegan/palm-oil analysis, image); /v1/search = full-text product search; /v1/category = browse a category (e.g. shampoos, lipsticks, deodorants, sunscreens). Open data, contributor-maintained — coverage and completeness vary by product.","source":"Open Beauty Facts — the open cosmetics & personal-care product database (world.openbeautyfacts.org)","endpoints":["/v1/product","/v1/search","/v1/category","/v1/meta"]},"meta":{"timestamp":"2026-05-31T15:22:26.025Z","request_id":"30c0e279-c718-4035-843a-16e3eb7fce14"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3820,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":385,"monthly_call_quota":52400,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1175,"monthly_call_quota":268000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3145,"monthly_call_quota":1330000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/beauty-api"}