cosdna.com APIcosdna.com ↗
Access CosDNA product data, ingredient safety ratings, supplier listings, and forum posts via 8 structured API endpoints. Analyze ingredient lists for acne and irritant scores.
curl -X GET 'https://api.parse.bot/scraper/9bcbfb6c-22be-4d42-9a24-08e297777710/search_products?page=1&query=sunscreen' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for cosmetic products by name. Returns paginated results with product IDs, names, links, and thumbnails.
| Param | Type | Description |
|---|---|---|
| page | string | Page number for pagination. |
| sort | string | Sort order for results. |
| queryrequired | string | Search keyword for products (e.g. 'sunscreen', 'moisturizer'). |
{
"type": "object",
"fields": {
"page": "string, the current page number",
"query": "string, the search query used",
"products": "array of product objects with product_id, name, link, and thumbnail fields"
},
"sample": {
"data": {
"page": "1",
"query": "sunscreen",
"products": [
{
"link": "https://www.cosdna.com/eng/cosmetic_73c6694771.html",
"name": "Peach & Lily Sun Cover Mineral Sunscreen 50ml",
"thumbnail": "https://www.cosdna.com/images/cos/sea3a694771.jpg",
"product_id": "73c6694771"
}
]
},
"status": "success"
}
}About the cosdna.com API
The CosDNA API exposes 8 endpoints covering cosmetic product search, ingredient analysis, supplier discovery, and community content from CosDNA.com. The get_product_details endpoint returns a full ingredient list for any product with per-ingredient safety, acne, and irritant ratings. The analyze_cosmetics endpoint lets you submit a raw ingredient list and receive the same structured ratings without needing a product ID.
Product and Ingredient Data
The search_products endpoint accepts a query string and returns paginated results — each with a product_id, name, link, and thumbnail. Pass that product_id to get_product_details to retrieve the full ingredient list for a product, where each ingredient object includes name, ingredient_id, function, acne, irritant, and safety fields. The product name is pulled from the page title and may carry a suffix such as "Ingredient Analysis".
For ingredient-level research, search_ingredients returns matching ingredient_id values that unlock get_ingredient_details. That endpoint surfaces chemical metadata (Formula, Molecular Weight, Cas No), synonyms, a description, and a list of up to 10 related products — useful for tracing which products use a specific compound.
Ingredient Analysis Without a Product ID
analyze_cosmetics accepts a comma-separated ingredient_list string and returns an analysis array with the same function, acne, irritant, and safety fields used in product details. This endpoint is practical for analyzing products not yet in the CosDNA database or for evaluating custom formulations against the site's rating system.
Suppliers, Reviews, and Forum
search_suppliers returns supplier product listings for a given ingredient query, including product_name, company, description, and link. Community data is available through get_latest_reviews, which returns the most recent user-submitted reviews shown on the CosDNA homepage (each with name and link), and get_forum_posts, which accepts a board_id (for example, 13 for Skincare) and a page parameter, returning paginated post title, link, and author fields.
- Scan a product's ingredient list for acne-triggering compounds using
get_product_detailsacne ratings. - Compare irritant scores across multiple products by querying
search_productsand batchingget_product_detailscalls. - Validate a custom formulation before production by submitting it to
analyze_cosmeticsand reviewing safety fields. - Identify raw material suppliers for a specific ingredient via
search_supplierscompany and description data. - Build an ingredient glossary by retrieving CAS numbers, molecular weights, and synonyms from
get_ingredient_details. - Monitor skincare community sentiment by scraping paginated forum posts with
get_forum_postsand a givenboard_id. - Populate a product recommendation feed using
get_latest_reviewsto surface recently reviewed items.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does CosDNA have an official developer API?+
What rating fields does `get_product_details` return per ingredient, and what do they represent?+
get_product_details returns acne, irritant, and safety as numeric fields on each ingredient object, alongside function and ingredient_id. These values correspond to the ratings CosDNA displays on its ingredient analysis pages. The ingredient_id can be passed to get_ingredient_details for additional chemical metadata on any listed ingredient.Does the forum endpoint return post content or just metadata?+
get_forum_posts returns title, link, and author for each post — it does not return the body text or replies of individual forum threads. The API covers the post listing level with board-level pagination via board_id and page. You can fork the API on Parse and revise it to add an endpoint that fetches individual thread content.Can I retrieve user-written review text, star ratings, or skin-type tags through this API?+
get_latest_reviews returns review name and link fields only — no rating scores, review body text, or user metadata. You can fork the API on Parse and revise it to add an endpoint that retrieves full review details from individual review pages.Is there a limitation on how many related products `get_ingredient_details` returns?+
related_products array in get_ingredient_details returns up to 10 product objects. If you need broader product coverage for a given ingredient, search_products with an ingredient name as the query is a practical alternative, and it supports pagination via the page parameter.