Shopify Scraper

ENDPOINTS
GETProduct Details
GETSearch Products
GETList Products
GETBest Sellers
GETNew Arrivals
GETProducts On Sale
GETProduct Recommendations
GETProduct Inventory
GETList Collections
GETCollection Details
GETCollection Products
GETSearch Suggestions
GETStore Profile
GETShopify Store Check
GETStore Apps
GETStore Theme
GETStore Contacts
GETStore Markets
GETStore Policies
GETStore Menus
GETCatalog Statistics
GETList Pages
GETPage Details
GETList Blogs
GETBlog Articles
GETArticle Details
GET/search/suggestions

Search Suggestions

Get typeahead suggestions for a partial query: query completions, products, collections, pages and articles.

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

Partial search text to complete.

Examples:

  • gloss
  • found

Comma-separated result types to return.

Default: all of them

Allowed values: product, collection, page, article, query

Example: product,query

How many results to return per type.

Default: 5

Allowed values: 1-10

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"
  },
  "query": "gloss",
  "queries": [
    {
      "text": "gloss bomb stix",
      "styled_text": "<mark>gloss</mark><span> bomb stix</span>"
    },
    {
      "text": "gloss bomb lip luminizer",
      "styled_text": "<mark>gloss</mark><span> bomb lip luminizer</span>"
    },
    {
      "text": "gloss bomb stix the mvp",
      "styled_text": "<mark>gloss</mark><span> bomb stix the mvp</span>"
    },
    {
      "text": "gloss bomb fenty glow",
      "styled_text": "<mark>gloss</mark><span> bomb fenty glow</span>"
    },
    {
      "text": "gloss bomb burst",
      "styled_text": "<mark>gloss</mark><span> bomb burst</span>"
    }
  ],
  "products": [
    {
      "id": 7727190540333,
      "handle": "gloss-bomb-stix-high-shine-gloss-stick-fenty-glow",
      "title": "Gloss Bomb Stix High-Shine Gloss Stick — Fenty Glow",
      "link": "https://fentybeauty.com/products/gloss-bomb-stix-high-shine-gloss-stick-fenty-glow",
      "vendor": "Fenty Beauty",
      "product_type": "Lip Gloss",
      "category": {
        "id": "hb-3-2-6-5-2",
        "name": "Lip Gloss"
      },
      "description": "It’s about to get juicy: luscious lip gloss and lipstick hooked up, and now you can get Gloss Bomb’s explosive shine in a color-packed stick. The moisture-lock formula is packed with lip-loving ingredients to condition, nourish and keep lips lookin' plump.",
      "tags": [
        "bb::7991030153261::discount::10",
        "bb::7991070949421::discount::15",
        "bb::8057724928045::discount::15",
        "bb::8122262421549::discount::15",
        "Benefits:Conditioning",
        "Benefits:Hydrating",
        "Benefits:Moisturizing",
        "Benefits:Nourishing",
        "Benefits:Shine",
        "Benefits:Smoothing",
        "catalog-exclude",
        "Color ID|FB40102",
        "Coverage:Buildable",
        "Finish:Shine",
        "Formulation:Stick",
        "Ingredient Preference:Shea Butter",
        "Ingredient Preference:Squalane",
        "Ingredient Preference:Vitamin E",
        "master-id|FB50010",
        "Product Type:Lip",
        "Product Type:Lip Gloss",
        "Product Type:Lipstick",
        "rose tan",
        "Size ID|3.6 g",
        "toffee nude",
        "YCRF_lip gloss",
        "YGroup_fb50010"
      ],
      "is_available": true,
      "is_gift_card": false,
      "is_subscription_only": false,
      "rating": 4.5,
      "reviews_count": 1199,
      "pricing": {
        "currency": "USD",
        "price": 27.0,
        "price_max": 27.0,
        "compare_at_price": null,
        "compare_at_price_max": null,
        "is_on_sale": false,
        "discount_percent": null,
        "has_price_range": false
      },
      "image": {
        "link": "https://cdn.shopify.com/s/files/1/0341/3458/9485/files/FB_FALL24_T2PRODUCT_ECOMM_GBSTICK_FENTYGLOW_OPEN_1200x1500_72DPI.jpg?v=1762285103",
        "alt_text": null,
        "width": 1200,
        "height": 1500
      },
      "options": [
        {
          "name": "Color",
          "values": [
            "Fenty Glow"
          ]
        }
      ],
      "variants_count": 1,
      "created_at": "2024-02-14T23:29:31Z",
      "updated_at": "2026-10-04T20:39:01Z",
      "published_at": "2024-07-02T19:09:07Z"
    },
    {
      "id": 8381985423405,
      "handle": "gloss-bomb-stix-high-shine-gloss-stick-rose-amber",
      "title": "Gloss Bomb Stix High-Shine Gloss Stick — Rose Amber",
      "link": "https://fentybeauty.com/products/gloss-bomb-stix-high-shine-gloss-stick-rose-amber",
      "vendor": "Fenty Beauty",
      "product_type": "Lip Gloss",
      "category": {
        "id": "hb-3-2-6-5-2",
        "name": "Lip Gloss"
      },
      "description": "It’s about to get juicy: luscious lip gloss and lipstick hooked up, and now you can get Gloss Bomb’s explosive shine in a color-packed stick. The moisture-lock formula is packed with lip-loving ingredients to condition, nourish and keep lips lookin' plump.",
      "tags": [
        "badge|BESTSELLER",
        "badge|RIHANNA'S FAVE",
        "bb::7991030153261::discount::10",
        "bb::7991070949421::discount::15",
        "bb::8057724928045::discount::15",
        "bb::8122262421549::discount::15",
        "Benefits:Conditioning",
        "Benefits:Moisturizing",
        "Benefits:Nourishing",
        "Benefits:Shine",
        "Benefits:Smoothing",
        "catalog-exclude",
        "Color ID|FB40133",
        "cool taupe-brown",
        "Coverage:Buildable",
        "Finish:Shine",
        "Formulation:Stick",
        "Ingredient Preference:Shea Butter",
        "Ingredient Preference:Squalane",
        "Ingredient Preference:Vitamin E",
        "master-id|FB50010",
        "Product Type:Lip",
        "Product Type:Lip Gloss",
        "Product Type:Lipstick",
        "she a ceo",
        "Size ID|3.6 g",
        "YCRF_lip gloss",
        "YGroup_fb50010"
      ],
      "is_available": true,
      "is_gift_card": false,
      "is_subscription_only": false,
      "rating": 4.5,
      "reviews_count": 1197,
      "pricing": {
        "currency": "USD",
        "price": 27.0,
        "price_max": 27.0,
        "compare_at_price": null,
        "compare_at_price_max": null,
        "is_on_sale": false,
        "discount_percent": null,
        "has_price_range": false
      },
      "image": {
        "link": "https://cdn.shopify.com/s/files/1/0341/3458/9485/files/FB_SPR26_T2PRODUCT_ECOMM_GB_ROSE-AMBER_1200x1500_72DPI.jpg?v=1771449143",
        "alt_text": null,
        "width": 1200,
        "height": 1500
      },
      "options": [
        {
          "name": "Color",
          "values": [
            "Rose Amber"
          ]
        }
      ],
      "variants_count": 1,
      "created_at": "2026-01-21T19:28:15Z",
      "updated_at": "2026-10-05T04:28:56Z",
      "published_at": "2026-02-20T04:46:03Z"
    },
    {
      "id": 7727190638637,
      "handle": "gloss-bomb-stix-high-shine-gloss-stick-riri",
      "title": "Gloss Bomb Stix High-Shine Gloss Stick — RiRi",
      "link": "https://fentybeauty.com/products/gloss-bomb-stix-high-shine-gloss-stick-riri",
      "vendor": "Fenty Beauty",
      "product_type": "Lip Gloss",
      "category": {
        "id": "hb-3-2-6-5-2",
        "name": "Lip Gloss"
      },
      "description": "It’s about to get juicy: luscious lip gloss and lipstick hooked up, and now you can get Gloss Bomb’s explosive shine in a color-packed stick.",
      "tags": [
        "ballin babe",
        "bb::7991030153261::discount::10",
        "bb::7991070949421::discount::15",
        "bb::8057724928045::discount::15",
        "bb::8122262421549::discount::15",
        "Benefits:Conditioning",
        "Benefits:Hydrating",
        "Benefits:Moisturizing",
        "Benefits:Nourishing",
        "Benefits:Shine",
        "Benefits:Smoothing",
        "catalog-exclude",
        "Color ID|FB40105",
        "Coverage:Buildable",
        "Finish:Shine",
        "Formulation:Stick",
        "Ingredient Preference:Shea Butter",
        "Ingredient Preference:Squalane",
        "Ingredient Preference:Vitamin E",
        "Is Batch Controlled",
        "master-id|FB50010",
        "Product Type:Lip",
        "Product Type:Lip Gloss",
        "Product Type:Lipstick",
        "rose mauve",
        "Size ID|3.6 g",
        "YCRF_lip gloss",
        "YGroup_fb50010"
      ],
      "is_available": true,
      "is_gift_card": false,
      "is_subscription_only": false,
      "rating": 4.5,
      "reviews_count": 1199,
      "pricing": {
        "currency": "USD",
        "price": 27.0,
        "price_max": 27.0,
        "compare_at_price": null,
        "compare_at_price_max": null,
        "is_on_sale": false,
        "discount_percent": null,
        "has_price_range": false
      },
      "image": {
        "link": "https://cdn.shopify.com/s/files/1/0341/3458/9485/files/FB_SPR26_T2PRODUCT_ECOMM_MINI_GB_STIX_RIRI_1200X1500_72DPI.jpg?v=1790722285",
        "alt_text": null,
        "width": 1200,
        "height": 1500
      },
      "options": [
        {
          "name": "Color",
          "values": [
            "RiRi"
          ]
        }
      ],
      "variants_count": 1,
      "created_at": "2024-02-14T23:29:32Z",
      "updated_at": "2026-10-05T09:35:46Z",
      "published_at": "2024-07-02T19:09:09Z"
    },
    {
      "id": 7727190736941,
      "handle": "gloss-bomb-stix-high-shine-gloss-stick-hot-chocolit",
      "title": "Gloss Bomb Stix High-Shine Gloss Stick — Hot Chocolit",
      "link": "https://fentybeauty.com/products/gloss-bomb-stix-high-shine-gloss-stick-hot-chocolit",
      "vendor": "Fenty Beauty",
      "product_type": "Lip Gloss",
      "category": {
        "id": "hb-3-2-6-5-2",
        "name": "Lip Gloss"
      },
      "description": "It’s about to get juicy: luscious lip gloss and lipstick hooked up, and now you can get Gloss Bomb’s explosive shine in a color-packed stick. The moisture-lock formula is packed with lip-loving ingredients to condition, nourish and keep lips lookin' plump.",
      "tags": [
        "bb::7991030153261::discount::10",
        "bb::7991070949421::discount::15",
        "bb::8057724928045::discount::15",
        "bb::8122262421549::discount::15",
        "Benefits:Conditioning",
        "Benefits:Hydrating",
        "Benefits:Moisturizing",
        "Benefits:Nourishing",
        "Benefits:Shine",
        "Benefits:Smoothing",
        "catalog-exclude",
        "chocolate bordeaux",
        "Color ID|FB40108",
        "Coverage:Buildable",
        "Finish:Shine",
        "Formulation:Stick",
        "Ingredient Preference:Shea Butter",
        "Ingredient Preference:Squalane",
        "Ingredient Preference:Vitamin E",
        "master-id|FB50010",
        "Product Type:Lip",
        "Product Type:Lip Gloss",
        "Product Type:Lipstick",
        "rich brown",
        "she a ceo",
        "Size ID|3.6 g",
        "YCRF_lip gloss",
        "YGroup_fb50010"
      ],
      "is_available": true,
      "is_gift_card": false,
      "is_subscription_only": false,
      "rating": 4.5,
      "reviews_count": 1197,
      "pricing": {
        "currency": "USD",
        "price": 27.0,
        "price_max": 27.0,
        "compare_at_price": null,
        "compare_at_price_max": null,
        "is_on_sale": false,
        "discount_percent": null,
        "has_price_range": false
      },
      "image": {
        "link": "https://cdn.shopify.com/s/files/1/0341/3458/9485/files/FB_FALL24_T2PRODUCT_ECOMM_GBSTICK_HOTCHOCOLIT_OPEN_1200x1500_72DPI.jpg?v=1762285107",
        "alt_text": null,
        "width": 1200,
        "height": 1500
      },
      "options": [
        {
          "name": "Color",
          "values": [
            "Hot Chocolit"
          ]
        }
      ],
      "variants_count": 1,
      "created_at": "2024-02-14T23:29:34Z",
      "updated_at": "2026-10-05T09:35:05Z",
      "published_at": "2024-07-02T19:09:33Z"
    },
    {
      "id": 7727190704173,
      "handle": "gloss-bomb-stix-high-shine-gloss-stick-spiced-cold",
      "title": "Gloss Bomb Stix High-Shine Gloss Stick — Sp'ice Cold",
      "link": "https://fentybeauty.com/products/gloss-bomb-stix-high-shine-gloss-stick-spiced-cold",
      "vendor": "Fenty Beauty",
      "product_type": "Lip Gloss",
      "category": {
        "id": "hb-3-2-6-5-2",
        "name": "Lip Gloss"
      },
      "description": "It’s about to get juicy: luscious lip gloss and lipstick hooked up, and now you can get Gloss Bomb’s explosive shine in a color-packed stick. The moisture-lock formula is packed with lip-loving ingredients to condition, nourish and keep lips lookin' plump.",
      "tags": [
        "bb::7991030153261::discount::10",
        "bb::7991070949421::discount::15",
        "bb::8057724928045::discount::15",
        "bb::8122262421549::discount::15",
        "Benefits:Conditioning",
        "Benefits:Hydrating",
        "Benefits:Moisturizing",
        "Benefits:Nourishing",
        "Benefits:Shine",
        "Benefits:Smoothing",
        "catalog-exclude",
        "Color ID|FB40107",
        "Coverage:Buildable",
        "Finish:Shine",
        "Formulation:Stick",
        "Ingredient Preference:Shea Butter",
        "Ingredient Preference:Squalane",
        "Ingredient Preference:Vitamin E",
        "master-id|FB50010",
        "pink brown",
        "Product Type:Lip",
        "Product Type:Lip Gloss",
        "Product Type:Lipstick",
        "she a ceo",
        "Size ID|3.6 g",
        "toffee nude",
        "YCRF_lip gloss",
        "YGroup_fb50010"
      ],
      "is_available": true,
      "is_gift_card": false,
      "is_subscription_only": false,
      "rating": 4.5,
      "reviews_count": 1199,
      "pricing": {
        "currency": "USD",
        "price": 27.0,
        "price_max": 27.0,
        "compare_at_price": null,
        "compare_at_price_max": null,
        "is_on_sale": false,
        "discount_percent": null,
        "has_price_range": false
      },
      "image": {
        "link": "https://cdn.shopify.com/s/files/1/0341/3458/9485/files/FB_FALL24_T2PRODUCT_ECOMM_GBSTICK_SPICEDCOLD_OPEN_1200x1500_72DPI.jpg?v=1762285106",
        "alt_text": null,
        "width": 1200,
        "height": 1500
      },
      "options": [
        {
          "name": "Color",
          "values": [
            "Sp'ice cold"
          ]
        }
      ],
      "variants_count": 1,
      "created_at": "2024-02-14T23:29:34Z",
      "updated_at": "2026-10-05T00:34:05Z",
      "published_at": "2024-07-02T19:09:32Z"
    }
  ],
  "collections": [
    {
      "id": 287666667565,
      "handle": "makeup-lip-gloss",
      "title": "Lip Gloss",
      "link": "https://fentybeauty.com/collections/makeup-lip-gloss",
      "image": null
    },
    {
      "id": 260546887725,
      "handle": "gloss-bomb-cream",
      "title": "Gloss Bomb Cream",
      "link": "https://fentybeauty.com/collections/gloss-bomb-cream",
      "image": null
    },
    {
      "id": 296491974701,
      "handle": "new-shimmering-gloss-bomb-stix-high-shine-gloss-stick",
      "title": "New! Shimmering Gloss Bomb Stix High-Shine Gloss-Stick",
      "link": "https://fentybeauty.com/collections/new-shimmering-gloss-bomb-stix-high-shine-gloss-stick",
      "image": null
    },
    {
      "id": 260523622445,
      "handle": "gloss-bomb-universal-lip-luminizer",
      "title": "Gloss Bomb Universal Lip Luminizer",
      "link": "https://fentybeauty.com/collections/gloss-bomb-universal-lip-luminizer",
      "image": {
        "link": "https://cdn.shopify.com/s/files/1/0341/3458/9485/collections/FB50001_FB5017.jpg?v=1621555628",
        "alt_text": null,
        "width": 1200,
        "height": 1500
      }
    },
    {
      "id": 278160736301,
      "handle": "mini-gloss-bomb-keychain-with-charm",
      "title": "Mini Gloss Bomb & Keychain with Charm",
      "link": "https://fentybeauty.com/collections/mini-gloss-bomb-keychain-with-charm",
      "image": null
    }
  ],
  "pages": [
    {
      "id": 106315251757,
      "handle": "the-gloss-shop",
      "title": "The Gloss Shop",
      "link": "https://fentybeauty.com/pages/the-gloss-shop"
    }
  ],
  "articles": [
    {
      "id": 571110424621,
      "handle": "different-types-of-lip-gloss-explained-high-shine-cream-plumping-more",
      "title": "Different Types of Lip Gloss Explained: High-Shine, Cream, Plumping + More",
      "link": "https://fentybeauty.com/blogs/the-fenty-blog/different-types-of-lip-gloss-explained-high-shine-cream-plumping-more",
      "image": {
        "link": "https://cdn.shopify.com/s/files/1/0341/3458/9485/articles/D-MULTI-PROMO-CAROUSEL_Lip-Glosses_9be06227-e173-482d-a3b6-60d5ba332511.jpg?v=1790571860",
        "alt_text": null,
        "width": 814,
        "height": 572
      },
      "blog": {
        "id": null,
        "handle": "the-fenty-blog",
        "title": "The Fenty Blog",
        "link": "https://fentybeauty.com/blogs/the-fenty-blog"
      }
    },
    {
      "id": 561319739437,
      "handle": "how-to-apply-lip-gloss",
      "title": "How to Apply Lip Gloss for a Plump, Shiny Pout: The Ultimate Guide",
      "link": "https://fentybeauty.com/blogs/the-fenty-blog/how-to-apply-lip-gloss",
      "image": {
        "link": "https://cdn.shopify.com/s/files/1/0341/3458/9485/articles/DESKTOP-BLOG_HERO_2_6233bd4a-aafc-4684-9f0e-ed6a519ce7a7.jpg?v=1761764376",
        "alt_text": null,
        "width": 1600,
        "height": 1600
      },
      "blog": {
        "id": null,
        "handle": "the-fenty-blog",
        "title": "The Fenty Blog",
        "link": "https://fentybeauty.com/blogs/the-fenty-blog"
      }
    }
  ]
}