Lookfantastic APIlookfantastic.com ↗
Extract beauty product listings, prices, ratings, reviews, and ingredient lists from lookfantastic.com via 2 structured API endpoints.
What is the Lookfantastic API?
The Lookfantastic API provides 2 endpoints to retrieve beauty product data from lookfantastic.com, covering everything from category-level listings to single-product detail pages. The list_products endpoint extracts multiple products from any category URL, returning SKU, brand, price, ratings, and full ingredient lists. The get_product_details endpoint goes deeper, adding verified purchase reviews, usage directions, and image URLs for a single product by SKU.
curl -X GET 'https://api.parse.bot/scraper/f44426d1-73c0-4eff-af36-72d6420d31f3/list_products?page=1&limit=3&category_url=https%3A%2F%2Fwww.lookfantastic.com%2Fc%2Fhealth-beauty%2Fface%2Fskincare-products%2F' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace lookfantastic-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Lookfantastic SDK — browse skincare products and drill into details."""
from parse_apis.lookfantastic_beauty_products_api import (
Lookfantastic,
ProductNotFound,
)
client = Lookfantastic()
# Browse a skincare category — limit= caps total items fetched.
category = client.category(url="https://www.lookfantastic.com/c/health-beauty/face/skincare-products/")
for product in category.list_products(limit=5):
print(product.name, product.brand, product.price.display)
# Drill into one product's full details via .details() nav-op.
summary = category.list_products(limit=1).first()
if summary:
full = summary.details()
print(full.name, full.ratings.average, full.ratings.total_reviews)
for review in full.reviews[:3]:
print(review.author, review.rating, review.title)
# Fetch a product directly by SKU.
try:
product = client.products.get(sku="13938507")
print(product.name, product.brand, product.ingredients[:80] if product.ingredients else "N/A")
except ProductNotFound as exc:
print(f"Product not found: {exc.sku}")
print("exercised: category.list_products / summary.details / products.get")Extract product listings from a category page on lookfantastic.com. Returns product name, brand, price, ratings, reviews, ingredient list, directions, and images for each product. SKUs are discovered from the HTML page, then hydrated via GraphQL. Pagination is applied locally over the discovered SKUs.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| limit | integer | Number of products to return per page. |
| category_urlrequired | string | Full URL of the category page to extract products from (e.g. https://www.lookfantastic.com/c/health-beauty/face/skincare-products/). |
{
"type": "object",
"fields": {
"page": "integer - Current page number",
"limit": "integer - Products per page",
"products": "array of product objects each containing sku, name, brand, url, price, ratings, reviews, ingredients, directions, images",
"total_found": "integer - Total product SKUs found on the category page",
"products_returned": "integer - Number of products in this response"
},
"sample": {
"data": {
"page": 1,
"limit": 3,
"products": [
{
"sku": 17777851,
"url": "https://www.lookfantastic.com/p/medik8-exo-pdrn-prismatic-serum-30ml/17777851/",
"name": "Medik8 Exo-PDRN Prismatic+ Serum 30ml",
"brand": "Medik8",
"price": {
"amount": "79.0",
"display": "£79.00",
"currency": "GBP"
},
"images": [
"https://static.thcdn.com/productimg/original/17777851-1105334663863256.jpg"
],
"ratings": {
"average": 4.79,
"total_reviews": 720
},
"reviews": [
{
"id": "1221718563",
"date": "2026-06-10",
"title": "beutiful texture",
"author": "Lindsay O.",
"rating": 5,
"content": null,
"verified_purchase": false
}
],
"directions": "<ul><li>AM/PM 1-2 pumps...</li></ul>",
"ingredients": "<p>Aqua (Water), Glycerin...</p>"
}
],
"total_found": 34,
"products_returned": 3
},
"status": "success"
}
}About the Lookfantastic API
Category Listings with list_products
Pass any valid lookfantastic.com category URL to the category_url parameter and the endpoint returns an array of product objects. Each object includes sku, name, brand, url, price, ratings, reviews, ingredients, directions, and images. The page and limit parameters control pagination across the full result set, and total_found tells you how many SKUs were identified on the category page so you can calculate how many pages to iterate.
Single-Product Detail with get_product_details
The get_product_details endpoint accepts a numeric sku (taken from a product URL) and returns the complete data record for that product. The price field is an object with amount, currency, and display subfields. The ratings object exposes average score and total_reviews count. The reviews array contains individual review objects with id, title, author, rating, content, date, and a verified_purchase boolean — useful for filtering trustworthy reviews. Both ingredients and directions are returned as raw HTML strings or null when the source page does not carry them.
Data Coverage Notes
Ingredient lists and usage directions are product-level fields and can vary in availability depending on the brand and category. Image URLs are returned as an array, so products with multiple gallery images all appear in the response. Reviews are returned in the structure they appear on the product page; there is no built-in sort or filter parameter for reviews within the endpoint itself.
The Lookfantastic API is a managed, monitored endpoint for lookfantastic.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when lookfantastic.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official lookfantastic.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a beauty product comparison tool using price, ratings, and brand fields across multiple categories.
- Monitor price changes on specific SKUs by polling
get_product_detailson a schedule. - Aggregate and analyze ingredient lists across skincare or haircare categories for formulation research.
- Filter products by average rating using the
ratings.averagefield returned from category listings. - Collect verified purchase reviews for sentiment analysis using the
verified_purchaseboolean in review objects. - Populate an affiliate product catalogue with images, descriptions, and live prices from category pages.
- Track review volume growth over time using
total_reviewsfrom repeated calls toget_product_details.
| 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 | 100 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 lookfantastic.com have an official developer API?+
What review data does `get_product_details` return, and can I filter reviews by rating or date?+
id, title, author, rating, content, date, and a verified_purchase boolean. There are no built-in filter parameters for rating or date within the endpoint — filtering must be done client-side after retrieving the full reviews array.Are ingredients and directions always present in the response?+
ingredients and directions are returned as HTML strings when the product page carries them, and as null when they are absent. Coverage depends on how completely the brand has populated the product page on lookfantastic.com.Does the API cover lookfantastic.com sites for other regions, such as the US or EU storefronts?+
Can I retrieve search results or filter products by price range through the API?+
list_products endpoint extracts products from a category URL you supply — it does not expose search queries or server-side price filtering as parameters. Products returned reflect what appears on the given category page. You can fork this API on Parse and revise it to add a search-based endpoint or price-filter logic.