phia.com APIphia.com ↗
Access Phia's fashion marketplace via API: search products, get price intelligence, browse brands, retrieve editorial collections, and find visually similar items.
curl -X GET 'https://api.parse.bot/scraper/424f64a4-2dd9-4178-817a-f0134a431c5e/search_products?limit=3&query=summer+dress&offset=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for fashion products by keyword query. Returns paginated product listings with name, price, retailer/store, image URL, and availability details.
| Param | Type | Description |
|---|---|---|
| limit | integer | Max results per page |
| queryrequired | string | Search keyword (e.g., 'gucci bag', 'summer dress') |
| offset | integer | Pagination offset |
{
"type": "object",
"fields": {
"offset": "integer current offset",
"hasMore": "boolean indicating more results available",
"results": "array of product objects with id, name, priceUsd, imgUrl, productUrl, sourceDisplayName, onSale",
"searchId": "string unique search session identifier",
"numProducts": "integer total matching products"
},
"sample": {
"data": {
"offset": 3,
"hasMore": true,
"results": [
{
"id": "ENTITY_TYPE_PRODUCT-ae1a1c4984e1464d",
"name": "Old Navy Women's Airy Smocked Maxi Dress",
"imgUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:...",
"onSale": true,
"priceUsd": "19.99",
"productUrl": "https://www.google.com/search?q=summer+dress+women+new...",
"sizeDisplayName": "",
"primaryBrandName": "",
"sourceDisplayName": "Old Navy"
}
],
"searchId": "2bb96610-5142-40ed-8a18-22a7b1e8cfc2",
"endCursor": null,
"numProducts": 333
},
"status": "success"
}
}About the phia.com API
The Phia API exposes 11 endpoints covering fashion product search, price intelligence, brand browsing, and editorial collections from Phia's multi-retailer marketplace. search_products returns paginated listings with price, retailer, sale status, and image URL across hundreds of brands, while get_price_assessment delivers resale ratio, deal classification, and average resale value for any product — giving developers the data needed to build price-aware fashion tools.
Product Search and Discovery
The search_products endpoint accepts a query string (e.g., 'gucci bag', 'summer dress') plus optional limit and offset parameters for pagination. Each result object in the results array includes id, name, priceUsd, imgUrl, productUrl, sourceDisplayName, and onSale — enough to render a shoppable product card with retailer attribution. The numProducts and hasMore fields support building paginated result views. For type-ahead interfaces, get_autocomplete_suggestions takes a partial query and returns keyword, type, and directType fields to power real-time search inputs. get_popular_searches returns ranked trending terms with rank, query, category, isFemale, and isTrending — no parameters required.
Price Intelligence
get_price_assessment accepts a product name, brand, price, and product_url, and returns a dealType classification (e.g., 'GREAT_DEAL', 'GOOD_FIND'), a resaleRatio percentage, averageResaleValue, firsthandCount, secondhandCount, and price thresholds for both market segments. lookup_product_by_url accepts any external retailer URL and returns scrapedName, scrapedBrand, scrapedPrice, dealType, resaleRatio, and averageResaleValue — useful when you have a product URL but not structured metadata. Together these endpoints provide both first-hand and second-hand market context for a given item.
Brands, Editorials, and Visual Similarity
get_explore_brands returns a paginated list of brands with id, displayName, logoUrl, and websiteUrl. Once you have a brand name, get_brand_products accepts that name as brand_id and returns paginated product listings including primaryBrandName and sourceDisplayName. For content-driven surfaces, get_editorials returns curated collections with title, description, gender, collectionId, and nested author objects (including handle and imgUrl). Products within a collection are fetched via get_editorial_products using the collection_id from the prior call, returning brand, itemName, parsedPrice, imageLink, and linkToProduct.
Visual Similarity
get_visually_similar_products accepts the same four inputs as get_price_assessment — name, brand, price, and product_url — and returns two arrays: top_products and similar_style_products. This is useful for building "you might also like" features or cross-retailer style matching without managing your own embedding infrastructure.
- Build a price tracker that monitors
dealTypeandresaleRatiochanges for a watchlisted item usingget_price_assessment. - Power a fashion search bar with real-time type-ahead using
get_autocomplete_suggestionsandkeywordresponse fields. - Aggregate trending fashion terms by category and gender from
get_popular_searchesfor a trend-reporting dashboard. - Render editorial lookbooks by chaining
get_editorialsandget_editorial_productsto display curated collections with author attribution. - Build a brand directory with logo, website, and product catalog by combining
get_explore_brandsandget_brand_products. - Add a 'similar items' widget to a product page using
get_visually_similar_productswithtop_productsandsimilar_style_products. - Evaluate any retailer product URL for resale potential by passing it to
lookup_product_by_urland surfacingaverageResaleValueanddealType.
| 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 Phia offer an official developer API?+
What does `get_price_assessment` return beyond just a price comparison?+
get_price_assessment returns a dealType label, a resaleRatio indicating what percentage of retail value is retained on resale, averageResaleValue, separate counts for firsthandCount and secondhandCount listings, priceDifference from the market average, and distinct price thresholds for first-hand and second-hand markets. You pass in name, brand, price, and product_url to get all of these back.Does the API return user reviews or ratings for products?+
How does pagination work across the endpoints that support it?+
search_products, get_brand_products, and get_explore_brands all accept limit and offset integer parameters. search_products also returns numProducts (total count) and hasMore (boolean) so you can determine whether additional pages exist before issuing the next request. get_brand_products similarly returns hasMore and numProducts.Does the API expose inventory levels or size availability for products?+
onSale, priceUsd, productUrl, and sourceDisplayName, but granular size availability or stock levels are not part of the response schema. You can fork this API on Parse and revise it to add an endpoint that retrieves size or inventory details from individual product pages.