Shopify Scraper

ENDPOINTS
GET/store/catalog-stats

Catalog Statistics

Get catalog statistics: price distribution, discounts, availability, top vendors, types, tags and new products.

QUERY PARAMS

Store domain or any link on the store. Works for every Shopify store, including headless ones.

Examples:

  • Domain: fentybeauty.com
  • URL: https://fentybeauty.com/collections/makeup-lip
  • Shopify domain: fenty-beauty-us.myshopify.com

How many products to analyze at most. Stores with fewer products are analyzed in full.

Default: 2500

Allowed values: 1-10000

2-letter country code of the market to read: prices come back in that market's currency. Falls back to the store's default market when the store does not sell there.

Default: the store's own market

Allowed values: any ISO 3166-1 alpha-2 code (US, CA, GB, DE, FR, JP, ...)

Language for titles and descriptions, when the store publishes it.

Default: the store's own language

Allowed values: any ISO 639-1 code (en, fr, de, es, ja, ...)

{
  "store": "fentybeauty.com",
  "market": {
    "country": "US",
    "language": "en"
  },
  "products_scanned": 1034,
  "is_complete": true,
  "prices": {
    "currency": "USD",
    "min": 0.0,
    "max": 190.0,
    "average": 32.34,
    "median": 27.0,
    "percentile_25": 18.0,
    "percentile_75": 41.0,
    "histogram": [
      {
        "from": 0.0,
        "to": 19.0,
        "count": 281
      },
      {
        "from": 19.0,
        "to": 38.0,
        "count": 392
      },
      {
        "from": 38.0,
        "to": 57.0,
        "count": 265
      },
      {
        "from": 57.0,
        "to": 76.0,
        "count": 52
      },
      {
        "from": 76.0,
        "to": 95.0,
        "count": 18
      },
      {
        "from": 95.0,
        "to": 114.0,
        "count": 13
      },
      {
        "from": 114.0,
        "to": 133.0,
        "count": 5
      },
      {
        "from": 133.0,
        "to": 152.0,
        "count": 5
      },
      {
        "from": 152.0,
        "to": 171.0,
        "count": 1
      },
      {
        "from": 171.0,
        "to": 190.0,
        "count": 2
      }
    ]
  },
  "discounts": {
    "on_sale_count": 102,
    "on_sale_percent": 9.9,
    "average_discount_percent": 46.0,
    "max_discount_percent": 55.9
  },
  "availability": {
    "available_count": 870,
    "unavailable_count": 164,
    "available_percent": 84.1
  },
  "new_products": {
    "last_7_days": 0,
    "last_30_days": 2,
    "last_90_days": 62,
    "newest_created_at": "2026-11-03T23:41:39Z",
    "oldest_created_at": "2021-01-27T00:42:26Z"
  },
  "vendors_count": 7,
  "vendors": [
    {
      "name": "Fenty Beauty",
      "count": 847
    },
    {
      "name": "Fenty Skin",
      "count": 126
    },
    {
      "name": "Fenty Hair",
      "count": 34
    },
    {
      "name": "Fenty Fragrance",
      "count": 16
    },
    {
      "name": "Fenty",
      "count": 9
    },
    {
      "name": "NARVARDELIVERYPROTECTION",
      "count": 1
    },
    {
      "name": "Nami Matcha",
      "count": 1
    }
  ],
  "product_types_count": 67,
  "product_types": [
    {
      "name": "Foundations & Concealers",
      "count": 389
    },
    {
      "name": "Lip Gloss",
      "count": 89
    },
    {
      "name": "Blushes & Bronzers",
      "count": 69
    },
    {
      "name": "Highlighters & Luminizers",
      "count": 38
    },
    {
      "name": "Lipstick",
      "count": 32
    },
    {
      "name": "Eyeliner",
      "count": 29
    },
    {
      "name": "Phone Accessories",
      "count": 28
    },
    {
      "name": "Bundle Builder",
      "count": 26
    },
    {
      "name": "Lip Balms & Treatments",
      "count": 22
    },
    {
      "name": "Lotion & Moisturizer",
      "count": 19
    },
    {
      "name": "Makeup Brushes",
      "count": 19
    },
    {
      "name": "Bath & Body",
      "count": 19
    },
    {
      "name": "Eye Shadow",
      "count": 17
    },
    {
      "name": "Lip Liner",
      "count": 16
    },
    {
      "name": "Face Powder",
      "count": 15
    },
    {
      "name": "Eyebrow Enhancers",
      "count": 14
    },
    {
      "name": "Apparel",
      "count": 14
    },
    {
      "name": "Skin Care",
      "count": 12
    },
    {
      "name": "Hair Styling Products",
      "count": 11
    },
    {
      "name": "Skin Care Masks & Peels",
      "count": 9
    },
    {
      "name": "Cosmetic Sets",
      "count": 8
    },
    {
      "name": "Perfume & Cologne",
      "count": 7
    },
    {
      "name": "Hair Care Kits",
      "count": 7
    },
    {
      "name": "Cosmetics",
      "count": 7
    },
    {
      "name": "Body Makeup",
      "count": 6
    },
    {
      "name": "Lip & Cheek Stains",
      "count": 6
    },
    {
      "name": "US",
      "count": 5
    },
    {
      "name": "Cosmetic & Toiletry Bags",
      "count": 4
    },
    {
      "name": "Toners",
      "count": 4
    },
    {
      "name": "Mascara",
      "count": 4
    },
    {
      "name": "Face Mirrors",
      "count": 3
    },
    {
      "name": "Face Primer",
      "count": 3
    },
    {
      "name": "Sunscreen",
      "count": 3
    },
    {
      "name": "Conditioner",
      "count": 3
    },
    {
      "name": "Eye Makeup",
      "count": 3
    },
    {
      "name": "Value Set",
      "count": 3
    },
    {
      "name": "Mobile Phone Stands",
      "count": 3
    },
    {
      "name": "Makeup Sponges",
      "count": 2
    },
    {
      "name": "Accessories",
      "count": 2
    },
    {
      "name": "Lotions & Moisturizers",
      "count": 2
    },
    {
      "name": "Shampoo",
      "count": 2
    },
    {
      "name": "Hair Styling Tools",
      "count": 2
    },
    {
      "name": "Cosmetic Tools",
      "count": 2
    },
    {
      "name": "Makeup Bag",
      "count": 2
    },
    {
      "name": "Fenty Hair Sample",
      "count": 2
    },
    {
      "name": "Lip Makeup",
      "count": 2
    },
    {
      "name": "Makeup Finishing Sprays",
      "count": 2
    },
    {
      "name": "Eyeshadow",
      "count": 2
    },
    {
      "name": "Facial Cleansers",
      "count": 2
    },
    {
      "name": "Headphone Carrying Case",
      "count": 2
    }
  ],
  "tags_count": 1718,
  "tags": [
    {
      "name": "catalog-exclude",
      "count": 896
    },
    {
      "name": "Tax Class ID|Cosmetics",
      "count": 582
    },
    {
      "name": "Is Batch Controlled",
      "count": 572
    },
    {
      "name": "full-size",
      "count": 394
    },
    {
      "name": "Benefits:Longwear",
      "count": 345
    },
    {
      "name": "Formulation:Liquid",
      "count": 287
    },
    {
      "name": "Benefits:Hydrating",
      "count": 215
    },
    {
      "name": "bb::8014311718957::discount::15",
      "count": 202
    },
    {
      "name": "Coverage:Buildable",
      "count": 198
    },
    {
      "name": "Coverage:Medium",
      "count": 186
    },
    {
      "name": "Product Type:Foundation",
      "count": 181
    },
    {
      "name": "Product Type:Lip",
      "count": 173
    },
    {
      "name": "Product Type: Eye Makeup",
      "count": 160
    },
    {
      "name": "Formulation:Stick",
      "count": 157
    },
    {
      "name": "Finish:Matte",
      "count": 156
    },
    {
      "name": "YCRF_foundation",
      "count": 156
    },
    {
      "name": "CDP 17",
      "count": 153
    },
    {
      "name": "bb::8016078110765::discount::20",
      "count": 153
    },
    {
      "name": "show-size-selector",
      "count": 146
    },
    {
      "name": "Finish:Shimmer",
      "count": 146
    },
    {
      "name": "hide-from-search",
      "count": 138
    },
    {
      "name": "bb::8022375530541::discount::10",
      "count": 127
    },
    {
      "name": "Formulation:Cream",
      "count": 116
    },
    {
      "name": "Product Type:Concealer + Corrector",
      "count": 107
    },
    {
      "name": "badge|NEW",
      "count": 107
    },
    {
      "name": "Formulation:Powder",
      "count": 103
    },
    {
      "name": "nsg",
      "count": 102
    },
    {
      "name": "bb::8220816310317::discount::15",
      "count": 102
    },
    {
      "name": "Finish:Natural",
      "count": 101
    },
    {
      "name": "Product Type:Lip Gloss",
      "count": 100
    },
    {
      "name": "YCRF_lip gloss",
      "count": 92
    },
    {
      "name": "Finish: Soft-Matte",
      "count": 90
    },
    {
      "name": "hide",
      "count": 88
    },
    {
      "name": "Coverage:Full",
      "count": 86
    },
    {
      "name": "bb::7991030153261::discount::10",
      "count": 82
    },
    {
      "name": "YCRF_fenty_skin",
      "count": 75
    },
    {
      "name": "Ingredient Preferences: Oil- Free",
      "count": 75
    },
    {
      "name": "status:hidden",
      "count": 73
    },
    {
      "name": "Product Type:Bundle",
      "count": 73
    },
    {
      "name": "YBlocklist",
      "count": 71
    },
    {
      "name": "Yblocklist",
      "count": 69
    },
    {
      "name": "Finish:Shine",
      "count": 68
    },
    {
      "name": "Benefits:Smoothing",
      "count": 64
    },
    {
      "name": "badge|BESTSELLER",
      "count": 62
    },
    {
      "name": "bb::8057724928045::discount::15",
      "count": 60
    },
    {
      "name": "Benefits:Brightening",
      "count": 60
    },
    {
      "name": "Benefits:Moisturizing",
      "count": 60
    },
    {
      "name": "Product Type:Lipstick",
      "count": 59
    },
    {
      "name": "bb::7991070949421::discount::15",
      "count": 58
    },
    {
      "name": "Benefits:Waterproof",
      "count": 56
    },
    {
      "name": "Product Type:Sets",
      "count": 56
    },
    {
      "name": "Product Type:Highlighter",
      "count": 55
    },
    {
      "name": "YCRF_concealer",
      "count": 53
    },
    {
      "name": "Size ID|1.08 oz / 32 mL",
      "count": 52
    },
    {
      "name": "Finish:Natural Matte",
      "count": 51
    },
    {
      "name": "master-id|FB30010",
      "count": 50
    },
    {
      "name": "YGroup_fb30010",
      "count": 50
    },
    {
      "name": "master-id|FB30006",
      "count": 50
    },
    {
      "name": "YGroup_fb30006",
      "count": 50
    },
    {
      "name": "Coverage:Light",
      "count": 50
    },
    {
      "name": "Product Type:Skin Tint",
      "count": 50
    },
    {
      "name": "Benefits:Conditioning",
      "count": 50
    },
    {
      "name": "YGroup_FB30030",
      "count": 50
    },
    {
      "name": "master-id|FB40029",
      "count": 50
    },
    {
      "name": "Ygroup_FB40029",
      "count": 50
    },
    {
      "name": "master-id|FB40025",
      "count": 50
    },
    {
      "name": "YCRF_pfff",
      "count": 50
    },
    {
      "name": "YGroup_fb40025",
      "count": 50
    },
    {
      "name": "master-id|FB40024",
      "count": 50
    },
    {
      "name": "Shade Range:Deep",
      "count": 49
    },
    {
      "name": "badge|SOFT MATTE",
      "count": 49
    },
    {
      "name": "Size ID|12 mL/ 0.4 fl. oz",
      "count": 49
    },
    {
      "name": "Size ID|32 mL/ 1.08 oz",
      "count": 49
    },
    {
      "name": "Benefits:Nourishing",
      "count": 49
    },
    {
      "name": "bb::8057693667373::discount::15",
      "count": 48
    },
    {
      "name": "Shade Range:Medium-Deep",
      "count": 47
    },
    {
      "name": "Shade Range:Medium",
      "count": 46
    },
    {
      "name": "Benefits:Blurring",
      "count": 46
    },
    {
      "name": "Shade Range:Light-Medium",
      "count": 43
    },
    {
      "name": "Size ID|0.27 oz / 8 mL",
      "count": 43
    },
    {
      "name": "example-product",
      "count": 41
    },
    {
      "name": "bb::8122262421549::discount::15",
      "count": 41
    },
    {
      "name": "Concerns:Dryness",
      "count": 40
    },
    {
      "name": "Shade Range:Light",
      "count": 40
    },
    {
      "name": "Product Type:Contour",
      "count": 40
    },
    {
      "name": "Product Type:Blush",
      "count": 39
    },
    {
      "name": "bb::8026640318509::discount::10",
      "count": 38
    },
    {
      "name": "bb::8016119070765::discount::15",
      "count": 37
    },
    {
      "name": "virtual_bundle",
      "count": 37
    },
    {
      "name": "Ingredient Preference:Shea Butter",
      "count": 37
    },
    {
      "name": "Benefits:Shine",
      "count": 37
    },
    {
      "name": "Is Batch Control",
      "count": 37
    },
    {
      "name": "Product Type:Eyeshadow",
      "count": 36
    },
    {
      "name": "YCRF_highlighter",
      "count": 35
    },
    {
      "name": "Ingredient Preference:Vitamin E",
      "count": 35
    },
    {
      "name": "master-id|fb30030",
      "count": 34
    },
    {
      "name": "Is Hazardous",
      "count": 33
    },
    {
      "name": "Product Type:Body",
      "count": 33
    },
    {
      "name": "Product Type:Bronzer",
      "count": 32
    },
    {
      "name": "badge|LIMITED EDITION",
      "count": 32
    }
  ]
}