Shopify Scraper

ENDPOINTS
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",
      "styled_text": "<mark>gloss</mark>"
    },
    {
      "text": "gloss bomb",
      "styled_text": "<mark>gloss</mark><span> bomb</span>"
    },
    {
      "text": "gloss bomb heat",
      "styled_text": "<mark>gloss</mark><span> bomb heat</span>"
    },
    {
      "text": "gloss bomb prismatic lip luminizer",
      "styled_text": "<mark>gloss</mark><span> bomb prismatic lip luminizer</span>"
    },
    {
      "text": "gloss bomb stackz",
      "styled_text": "<mark>gloss</mark><span> bomb stackz</span>"
    }
  ],
  "products": [
    {
      "id": 5293600047149,
      "handle": "gloss-bomb-universal-lip-luminizer-fuy",
      "title": "Gloss Bomb Universal Lip Luminizer — Fu$$y",
      "link": "https://fentybeauty.com/products/gloss-bomb-universal-lip-luminizer-fuy",
      "vendor": "Fenty Beauty",
      "product_type": "Lip Gloss",
      "category": {
        "id": "hb-3-2-6-5-2",
        "name": "Lip Gloss"
      },
      "description": "Intense shine, ultimate lip gloss must-have. Fenty Beauty Gloss Bomb adds the perfect finishing touch to your Fenty Face. Feel and look fabulous!",
      "tags": [
        "badge|BESTSELLER",
        "bb::8057724928045::discount::15",
        "catalog-exclude",
        "Color ID|FB5006",
        "Finish:Shimmer",
        "Formulation:Liquid",
        "full-size",
        "fussy",
        "Is Batch Controlled",
        "master-id|FB50001",
        "pink",
        "Product Type:Lip",
        "Product Type:Lip Gloss",
        "show-size-selector",
        "Size ID|5.5 mL",
        "Size ID|9 mL",
        "Tax Class ID|Cosmetics",
        "YCRF_lip gloss",
        "YGroup_fb50001"
      ],
      "is_available": true,
      "is_gift_card": false,
      "is_subscription_only": false,
      "rating": 4.7,
      "reviews_count": 7554,
      "pricing": {
        "currency": "USD",
        "price": 16.0,
        "price_max": 23.0,
        "compare_at_price": null,
        "compare_at_price_max": null,
        "is_on_sale": false,
        "discount_percent": null,
        "has_price_range": true
      },
      "image": {
        "link": "https://cdn.shopify.com/s/files/1/0341/3458/9485/files/FB_HOLII18_PRODUCT_GLOSS_BOMB_FU_Y_CLOSED_FULLRES_1200X1500_72DPI.jpg?v=1762198482",
        "alt_text": "A closed tube of Gloss Bomb Universal Lip Luminizer in the shade Fu$$y on a grey background.",
        "width": 1200,
        "height": 1500
      },
      "options": [
        {
          "name": "Color",
          "values": [
            "Fu$$y"
          ]
        },
        {
          "name": "Size",
          "values": [
            "Standard",
            "Mini"
          ]
        }
      ],
      "variants_count": 2,
      "created_at": "2021-01-27T00:46:58Z",
      "updated_at": "2026-11-20T11:02:35Z",
      "published_at": "2021-01-27T00:46:58Z"
    },
    {
      "id": 15176635252781,
      "handle": "gloss-bomb-stix-high-shine-gloss-stick-caviar-crystalz",
      "title": "Gloss Bomb Stix High-Shine Gloss Stick — Caviar Crystalz",
      "link": "https://fentybeauty.com/products/gloss-bomb-stix-high-shine-gloss-stick-caviar-crystalz",
      "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",
        "bb::8057724928045::discount::15",
        "Benefits:Conditioning",
        "Benefits:Moisturizing",
        "Benefits:Nourishing",
        "Benefits:Smoothing",
        "catalog-exclude",
        "Color ID|FB40100",
        "Coverage:Buildable",
        "crystals",
        "Finish:Shimmer",
        "Formulation:Stick",
        "how many carats",
        "Ingredient Preference:Shea Butter",
        "Ingredient Preference:Squalane",
        "Ingredient Preference:Vitamin E",
        "karats",
        "major flex",
        "master-id|FB50010",
        "midnight diamonds",
        "Product Type:Lip",
        "Product Type:Lip Gloss",
        "Product Type:Lipstick",
        "roblox",
        "shimmering holographic black",
        "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": 1239,
      "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_FALL26_T2PRODUCT_ECOMM_LE_MIDNIGHT-DIAMONDS-COLLECTION_GLOSSBOMB_STIX_CAVIAR-CRYSTALZ_1200X1500_72DPI.jpg?v=1784236781",
        "alt_text": null,
        "width": 1200,
        "height": 1500
      },
      "options": [
        {
          "name": "Color",
          "values": [
            "Caviar Crystalz"
          ]
        }
      ],
      "variants_count": 1,
      "created_at": "2026-07-14T18:26:44Z",
      "updated_at": "2026-11-20T08:19:45Z",
      "published_at": "2026-07-19T04:00:06Z"
    },
    {
      "id": 5293586776109,
      "handle": "gloss-bomb-universal-lip-luminizer-glass-slipper",
      "title": "Gloss Bomb Universal Lip Luminizer — Glass Slipper",
      "link": "https://fentybeauty.com/products/gloss-bomb-universal-lip-luminizer-glass-slipper",
      "vendor": "Fenty Beauty",
      "product_type": "Lip Gloss",
      "category": {
        "id": "hb-3-2-6-5-2",
        "name": "Lip Gloss"
      },
      "description": "Intense shine, ultimate lip gloss must-have. Fenty Beauty Gloss Bomb adds the perfect finishing touch to your Fenty Face. Feel and look fabulous!",
      "tags": [
        "bb::7991030153261::discount::10",
        "bb::7991070949421::discount::15",
        "bb::8026640318509::discount::10",
        "bb::8057724928045::discount::15",
        "catalog-exclude",
        "Color ID|FB5016",
        "Finish:Shimmer",
        "Finish:Shine",
        "Formulation:Liquid",
        "full-size",
        "Is Batch Controlled",
        "master-id|FB50001",
        "Product Type:Lip",
        "Product Type:Lip Gloss",
        "show-size-selector",
        "Size ID|5.5 mL",
        "Size ID|9 mL",
        "Tax Class ID|Cosmetics",
        "YCRF_lip gloss",
        "YGroup_fb50001"
      ],
      "is_available": true,
      "is_gift_card": false,
      "is_subscription_only": false,
      "rating": 4.7,
      "reviews_count": 7554,
      "pricing": {
        "currency": "USD",
        "price": 16.0,
        "price_max": 23.0,
        "compare_at_price": null,
        "compare_at_price_max": null,
        "is_on_sale": false,
        "discount_percent": null,
        "has_price_range": true
      },
      "image": {
        "link": "https://cdn.shopify.com/s/files/1/0341/3458/9485/files/FB_SPR20_II_T2PRODUCT_CONCRETE_CLEAR_GLOSS_BOMB_CLOSED_1200x1500_14fd1a9f-9d29-4c29-bbf1-ba4a22343ab8.jpg?v=1762198209",
        "alt_text": "A closed tube of Gloss Bomb Universal Lip Luminizer in the shade Glass Slipper on a grey background.",
        "width": 1200,
        "height": 1500
      },
      "options": [
        {
          "name": "Color",
          "values": [
            "Glass Slipper"
          ]
        },
        {
          "name": "Size",
          "values": [
            "Standard",
            "Mini"
          ]
        }
      ],
      "variants_count": 2,
      "created_at": "2021-01-27T00:43:33Z",
      "updated_at": "2026-11-20T07:11:05Z",
      "published_at": "2021-01-27T00:43:33Z"
    },
    {
      "id": 15176741290029,
      "handle": "gloss-bomb-universal-lip-luminizer-caviar-crystalz",
      "title": "Gloss Bomb Universal Lip Luminizer — Caviar Crystalz",
      "link": "https://fentybeauty.com/products/gloss-bomb-universal-lip-luminizer-caviar-crystalz",
      "vendor": "Fenty Beauty",
      "product_type": "Lip Gloss",
      "category": {
        "id": "hb-3-2-6-5-2",
        "name": "Lip Gloss"
      },
      "description": "The boss of all lip gloss with explosive shine + universal shades spiked with Shea Butter, Vitamin E and Peptide for a nourishing lip gloss that feels as bomb as it looks.",
      "tags": [
        "bb::8057724928045::discount::15",
        "Benefits:Conditioning",
        "catalog-exclude",
        "Color ID|FB1004",
        "crystals",
        "Finish:Shimmer",
        "Formulation:Liquid",
        "how many carats",
        "Is Batch Controlled",
        "karats",
        "major flex",
        "master-id|FB50001",
        "midnight diamonds",
        "Product Type:Lip",
        "Product Type:Lip Gloss",
        "roblox",
        "shimmering holographic black",
        "Size ID|0.3 oz / 9 mL",
        "Tax Class ID|Cosmetics",
        "YCRF_lip gloss",
        "YGroup_fb50001"
      ],
      "is_available": true,
      "is_gift_card": false,
      "is_subscription_only": false,
      "rating": 4.7,
      "reviews_count": 7554,
      "pricing": {
        "currency": "USD",
        "price": 23.0,
        "price_max": 23.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_FALL26_T2PRODUCT_ECOMM_LE_MIDNIGHT-DIAMONDS-COLLECTION_GLOSSBOMB_CAVIAR-CRYSTALZ_1200X1500_72DPI.jpg?v=1784236782",
        "alt_text": null,
        "width": 1200,
        "height": 1500
      },
      "options": [
        {
          "name": "Color",
          "values": [
            "Caviar Crystalz"
          ]
        }
      ],
      "variants_count": 1,
      "created_at": "2026-07-14T18:35:38Z",
      "updated_at": "2026-11-20T08:49:45Z",
      "published_at": "2026-07-19T04:00:05Z"
    },
    {
      "id": 5293587857453,
      "handle": "gloss-bomb-universal-lip-luminizer-weet-mouth",
      "title": "Gloss Bomb Universal Lip Luminizer — $weet Mouth",
      "link": "https://fentybeauty.com/products/gloss-bomb-universal-lip-luminizer-weet-mouth",
      "vendor": "Fenty Beauty",
      "product_type": "Lip Gloss",
      "category": {
        "id": "hb-3-2-6-5-2",
        "name": "Lip Gloss"
      },
      "description": "The ultimate must-have lip gloss for an irresistible shine. Fenty Beauty Gloss Bomb adds the perfect finishing touch to your Fenty Face. Drip your lips out!",
      "tags": [
        "bb::7991030153261::discount::10",
        "bb::7991070949421::discount::15",
        "bb::8026640318509::discount::10",
        "bb::8057724928045::discount::15",
        "catalog-exclude",
        "Color ID|FB5014",
        "Finish:Shimmer",
        "Formulation:Liquid",
        "full-size",
        "Is Batch Controlled",
        "master-id|FB50001",
        "Product Type:Lip",
        "Product Type:Lip Gloss",
        "shimmering soft pink",
        "show-size-selector",
        "Size ID|5.5 mL",
        "Size ID|9 mL",
        "sweet mouth",
        "Tax Class ID|Cosmetics",
        "YCRF_lip gloss",
        "YGroup_fb50001"
      ],
      "is_available": true,
      "is_gift_card": false,
      "is_subscription_only": false,
      "rating": 4.7,
      "reviews_count": 7554,
      "pricing": {
        "currency": "USD",
        "price": 16.0,
        "price_max": 23.0,
        "compare_at_price": null,
        "compare_at_price_max": null,
        "is_on_sale": false,
        "discount_percent": null,
        "has_price_range": true
      },
      "image": {
        "link": "https://cdn.shopify.com/s/files/1/0341/3458/9485/files/FB_SPR20_II_T2PRODUCT_CONCRETE_GLOSS_BOMB_UNIV_LUMINIZER_SWEET_MOUTH_CLOSED_1200x1500_53833880-a9f0-4616-836f-4e552c64546f.jpg?v=1762198235",
        "alt_text": "A closed tube of Gloss Bomb Universal Lip Luminizer in the shade $weet Mouth on a grey background.",
        "width": 1200,
        "height": 1500
      },
      "options": [
        {
          "name": "Color",
          "values": [
            "$weet Mouth"
          ]
        },
        {
          "name": "Size",
          "values": [
            "Standard",
            "Mini"
          ]
        }
      ],
      "variants_count": 2,
      "created_at": "2021-01-27T00:43:50Z",
      "updated_at": "2026-11-20T10:33:26Z",
      "published_at": "2021-01-27T00:43:50Z"
    }
  ],
  "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": 571530313773,
      "handle": "gloss-bomb-sparkle-guide-find-your-shade",
      "title": "The Gloss Bomb Sparkle Guide: Find Your Shade + Shine",
      "link": "https://fentybeauty.com/blogs/the-fenty-blog/gloss-bomb-sparkle-guide-find-your-shade",
      "image": {
        "link": "https://cdn.shopify.com/s/files/1/0341/3458/9485/articles/FB949100_-_C_LAUNCH_GLOSS_BOMB_OG_SHADE_EXTENSION_GIMME_SPACE_ROSE_AMBER_090525_MULTI-PROMO_MOBILE.jpg?v=1793985852",
        "alt_text": null,
        "width": 480,
        "height": 336
      },
      "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"
      }
    },
    {
      "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": 571531591725,
      "handle": "fenty-lip-glosses-for-every-kind-of-shine",
      "title": "7 Fenty Lip Glosses for Every Kind of Shine",
      "link": "https://fentybeauty.com/blogs/the-fenty-blog/fenty-lip-glosses-for-every-kind-of-shine",
      "image": {
        "link": "https://cdn.shopify.com/s/files/1/0341/3458/9485/articles/FB_Tile_2__Lip_1000x_2cec6e97-5a7c-4e26-8cff-1ad513fa5e29.webp?v=1793985904",
        "alt_text": null,
        "width": 1000,
        "height": 1000
      },
      "blog": {
        "id": null,
        "handle": "the-fenty-blog",
        "title": "The Fenty Blog",
        "link": "https://fentybeauty.com/blogs/the-fenty-blog"
      }
    }
  ]
}