Fashionphile

Search Fashionphile products

Returns ranked products from Fashionphile's (https://www.fashionphile.com) own full-text and faceted product search, including condition grade, discount percentage, and other filter attributes not available from the classic catalog endpoints in this family. The storefront URL is fixed server-side. Omitting q browses the full catalog subject to any condition/vendor/availability filters and the chosen sort. By default only in-stock listings are searched, matching the storefront; availability=sold searches the sold archive instead. total_items is the exact number of products matching the query and all filters.

get/fashionphile/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/fashionphile/search
  • Auth: API key in header x-api-key

Query parameters

qstring

Search query text

condition'New' | 'Excellent' | 'Giftable' | 'Shows Wear' | 'Worn' | 'Flawed' | 'Fair'

Filter by condition grade. Allowed values: New, Excellent, Giftable, Shows Wear, Worn, Flawed, Fair

availability'available' | 'sold' | 'all'

Which listings to search. Allowed values: available (in-stock only, default), sold (sold archive only), all

vendorstring

Filter by exact designer/vendor name, e.g. Chanel

sort'relevance' | 'newest' | 'price_asc' | 'price_desc'

Sort order. Allowed values: relevance, newest, price_asc, price_desc

pageinteger

1-based page, defaults to 1

limitinteger

Maximum products, defaults to 20 and supports up to 50

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "availability": "available",
    "condition": "Excellent",
    "limit": 20,
    "page": 1,
    "products": [
      {
        "canonical_colour": "black",
        "colour": "black",
        "compare_at_price": 120,
        "condition": "Excellent",
        "discount_percentage": 20,
        "handle": "mens-wool-runners",
        "id": "6616124981328",
        "images": [
          {
            "alt": "Product image",
            "height": 1600,
            "id": "36411373027408",
            "position": 1,
            "url": "https://cdn.shopify.com/s/files/1/example.jpg",
            "width": 1600
          }
        ],
        "labels": [
          "new"
        ],
        "options": [
          {
            "name": "Size",
            "position": 1
          }
        ],
        "price": 98,
        "product_type": "Shoes",
        "rating": 4.2,
        "rating_count": 1549,
        "title": "Men's Wool Runners",
        "url": "https://www.allbirds.com/products/mens-wool-runners",
        "variants": [
          {
            "compare_at_price": 120,
            "grams": 400,
            "id": "34761278160941",
            "inventory_quantity": 24,
            "position": 1,
            "price": 98,
            "product_id": "6616124981328",
            "sku": "A123",
            "title": "Natural Black / 10"
          }
        ],
        "vendor": "Allbirds"
      }
    ],
    "query": "chanel",
    "sort": "relevance",
    "source_url": "https://www.fashionphile.com",
    "store_url": "https://www.fashionphile.com",
    "total_items": 184,
    "vendor": "Chanel"
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.