{
  "openapi": "3.0.1",
  "info": {
    "title": "Fashionphile Scraper | Listings, Prices and Sold Items",
    "description": "Fashionphile scraper for luxury resale listings, for sale or sold: asking price, price before markdown, estimated retail, condition with wear by zone, accessories, measurements, model and color. Search or filter by brand, category or condition. 100 listings in 17 seconds with 38 fields each.",
    "version": "1.0",
    "x-build-id": "ntN1Tb8o6WrqRZb3N"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~fashionphile-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-fashionphile-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/silentflow~fashionphile-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-fashionphile-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/silentflow~fashionphile-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-fashionphile-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "searchQueries": {
            "title": "🔎 Search",
            "type": "array",
            "description": "Words to search Fashionphile with, like on the site: <code>birkin 25</code>, <code>neverfull mm</code>, <code>rolex datejust</code>. Each search returns its best matches first, up to the limit below.",
            "items": {
              "type": "string"
            }
          },
          "itemIds": {
            "title": "🏷️ Item numbers or product links",
            "type": "array",
            "description": "Listings to check, one per line: the Fashionphile item number (<code>2015825</code>, shown as <i>Item #</i> on each page) or the product link (<code>https://www.fashionphile.com/products/hermes-togo-birkin-25-black-1973697</code>, older <code>/p/</code> links too). Each one returns its row, for sale or sold, whatever the limit below, so a list of 500 numbers returns 500 rows.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 Fashionphile links",
            "type": "array",
            "description": "Links copied from fashionphile.com:<ul><li>a designer or collection page, <code>https://www.fashionphile.com/collections/hermes-birkin-bags</code>, for the pieces for sale in it</li><li>a search page, <code>https://www.fashionphile.com/search?q=kelly</code></li><li>a product page, read like an item number above</li></ul>",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "maxItems": {
            "title": "🔢 Max listings per search or link",
            "minimum": 1,
            "type": "integer",
            "description": "The most listings returned for each search, each collection link and the catalog browse. Never cuts your item list: every item number always returns its own row. Large values are fine (the catalog holds about 32,000 pieces for sale).",
            "default": 50
          },
          "listingStatus": {
            "title": "📦 For sale or sold",
            "enum": [
              "available",
              "sold",
              "all"
            ],
            "type": "string",
            "description": "Pieces for sale today, pieces already sold (their last asking price, for price comparisons), or both.",
            "default": "available"
          },
          "brands": {
            "title": "👜 Brands",
            "type": "array",
            "description": "Keep only these designers: <code>Hermes</code>, <code>Chanel</code>, <code>Louis Vuitton</code>, <code>Rolex</code>. Common spellings work (<code>Hermès</code>, <code>Dior</code>, <code>YSL</code>, <code>LV</code>). Leave empty for every brand.",
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "title": "🗂️ Categories",
            "type": "array",
            "description": "Keep only these kinds of pieces. Leave empty for every category.",
            "items": {
              "type": "string",
              "enum": [
                "bags",
                "wallets",
                "accessories",
                "shoes",
                "jewelry",
                "watches",
                "belts",
                "scarves",
                "sunglasses"
              ],
              "enumTitles": [
                "Bags",
                "Wallets",
                "Accessories (wallets, pouches, belts, scarves, charms...)",
                "Shoes",
                "Jewelry",
                "Watches",
                "Belts",
                "Scarves",
                "Sunglasses"
              ]
            }
          },
          "conditions": {
            "title": "✨ Conditions",
            "type": "array",
            "description": "Keep only these condition groups, the ones the site filters by. Each row also carries the exact rating shown on the page (Excellent, Very Good, Good...).",
            "items": {
              "type": "string",
              "enum": [
                "new",
                "giftable",
                "excellent",
                "showsWear",
                "worn"
              ],
              "enumTitles": [
                "New",
                "Giftable",
                "Excellent",
                "Shows wear",
                "Worn"
              ]
            }
          },
          "postedWithin": {
            "title": "🆕 Listed within",
            "type": "string",
            "description": "Keep only pieces listed recently, newest first: <code>24 hours</code>, <code>3 days</code>, <code>2 weeks</code>, or a date like <code>2026-11-01</code>. Run it every day on your brands to catch new arrivals."
          },
          "includeDetails": {
            "title": "📋 Condition details",
            "type": "boolean",
            "description": "Add the model, exact color and material, condition rating and grade, the wear noted zone by zone (exterior, interior, handle, hardware), the accessories included, the measurements and the production year of each piece. Turn off for faster price and stock checks on very large lists.",
            "default": true
          },
          "debugMode": {
            "title": "🐞 Debug mode",
            "type": "boolean",
            "description": "Write detailed progress to the log.",
            "default": false
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}