defacto.com.tr APIdefacto.com.tr ↗
Access DeFacto's Turkish fashion catalog via API. Search products, browse categories, apply filters, and retrieve full product details including prices and sizes.
curl -X GET 'https://api.parse.bot/scraper/22c0353d-b227-4fb8-b925-2d02c14bab0e/search_products?page=1&query=elbise' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword on defacto.com.tr. Returns paginated results with product summaries including title, price, color, sizes, and stock information.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search keyword (e.g., 'tişört', 'elbise', 'ayakkabı') |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"count": "integer, number of products returned on this page",
"query": "string, the search keyword used",
"products": "array of product summaries with title, longCode, price, discountedPrice, colorName, sizes, stock, productUrl, imageUrl"
},
"sample": {
"data": {
"page": 1,
"count": 24,
"query": "elbise",
"products": [
{
"price": 1499.99,
"sizes": [
{
"name": "42",
"barcode": "8684582217944"
},
{
"name": "34",
"barcode": "8684582598821"
}
],
"stock": 51,
"title": "%100 Pamuk Kemerli Kolsuz Midi Elbise",
"seoName": "regular-fit-hakim-yaka-pamuklu-kisa-kollu-uzun-elbise",
"imageUrl": "https://dfcdn.defacto.com.tr/406/F7342AX_26SP_BE409_01_02.jpg",
"isOutlet": false,
"longCode": "F7342AX26SPBE409",
"colorName": "Mavi",
"productUrl": "https://www.defacto.com.tr/regular-fit-hakim-yaka-pamuklu-kisa-kollu-uzun-elbise-3420643",
"categoryName": "Elbise",
"discountedPrice": 1499.99,
"productVariantIndex": 3420643
}
]
},
"status": "success"
}
}About the defacto.com.tr API
The DeFacto API exposes 4 endpoints for searching and browsing defacto.com.tr's clothing catalog. Use search_products to query items by keyword and get back titles, prices in TL, discount prices, color names, size arrays, and stock status. Category browsing, filter discovery, and full product detail retrieval — including color variants and garment properties — are also covered.
Search and Category Browsing
The search_products endpoint accepts a query string (e.g., tişört, elbise, ayakkabı) and an optional page integer for pagination. Each product in the response includes title, longCode, price, discountedPrice, colorName, sizes, stock, productUrl, and imageUrl. The browse_category endpoint works similarly but takes a category_slug (e.g., erkek-t-shirt, kadin-elbise) and an optional filters string in key:value;key:value format — for example, renk:mavi to narrow to blue items.
Product Details and Filter Discovery
get_product_details accepts either a full URL or a path segment (e.g., /oversize-tisort-3374606) and returns the complete product record: images array, colorVariants (each with colorName, imageUrl, and url), structured properties such as Kalıp (fit), Yaka (collar), and Kol Boyu (sleeve length), categoryPath breadcrumb, and description when available. The get_search_filters endpoint takes a query and returns filter groups — Cinsiyet, Kategori, Beden, Renk, Fiyat, Yaka, Kol Boyu, Kalıp, and more — each with name and count fields so you can build dynamic filter UIs or pre-qualify filter values before calling browse_category.
Response Shape Notes
All filter names and values are in Turkish, matching the DeFacto site's locale. Prices are expressed in Turkish Lira (TL). The longCode field acts as a stable product identifier across search and detail responses, making it practical to cross-reference results. Both search and category endpoints return a count field indicating how many products are on the current page alongside the page number.
- Build a price-tracking tool that monitors
priceanddiscountedPricechanges for specificlongCodeproducts over time. - Aggregate size and stock availability across categories using
sizesandstockfields frombrowse_category. - Construct a color-filtered catalog view by passing
renk:valuefilters tobrowse_categoryafter discovering valid color options viaget_search_filters. - Generate product comparison pages by fetching
colorVariantsandpropertiesfromget_product_detailsfor multiple items. - Index DeFacto's category structure by iterating category slugs in
browse_categoryand collectingcategoryPathvalues from detail pages. - Power a fashion recommendation feed that surfaces
discountedPriceitems filtered by gender (Cinsiyet) and size (Beden) from filter discovery results. - Sync product image galleries using the
imagesarray fromget_product_detailsfor use in external merchandising tools.
| 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 DeFacto offer an official developer API?+
What does get_product_details return beyond what search results include?+
get_product_details returns the full images array, structured properties (Kalıp, Yaka, Kol Boyu), all colorVariants with their individual URLs and images, the categoryPath breadcrumb, and a description field. The search and browse endpoints return only summary fields: title, price, discountedPrice, colorName, sizes, stock, productUrl, and imageUrl.How do filters work with browse_category, and how do I know valid filter values?+
get_search_filters with a relevant query to retrieve filter groups and their available values with item counts. Then pass those values as a semicolon-delimited string to the filters parameter of browse_category — for example, renk:mavi;beden:M. All filter keys and values are in Turkish.Does the API expose customer reviews or ratings for products?+
Is pagination supported across all listing endpoints?+
search_products and browse_category both accept a page integer parameter and return page and count in their responses, allowing you to iterate through result pages. get_product_details and get_search_filters return single-page results by nature and do not use pagination.