{
  "name": "Ask Bestie Beauty API",
  "description": "Monthly popularity rankings of makeup: which products people actually buy, by estimated share of purchases, within observed US retailer lists.",
  "methodology": "https://beauty.askbestie.me/methodology/",
  "source": {
    "name": "Ask Bestie Beauty",
    "url": "https://beauty.askbestie.me",
    "dataMonth": "November 2026",
    "method": "Share = estimated % of purchases in a category that went to that product during the month, from beauty-retailer bestseller lists and sales counts in each market. Each ranking lists its sources. Change = percentage points vs the previous month, only given when both months use the same sources. Prices are omitted unless verified. Current coverage is Sephora and Ulta US only; purchaser identities and market coverage are unknown. Collection repeats weekly; there is no invented historical data.",
    "methodology": "https://beauty.askbestie.me/methodology/",
    "market": "United States",
    "signal": {
      "type": "estimated purchase share",
      "population": "Products in observed Sephora and Ulta US bestseller lists; purchaser identities and consumer/business split are not supplied",
      "basis": "Estimate from bestseller order using the published rank-to-share model; not measured sales",
      "coverage": "Sephora and Ulta US only, available categories are the ones with observed lists. National market coverage is unknown. Unobserved categories and months are unavailable.",
      "sources": [
        {
          "name": "Sephora US bestsellers",
          "url": "https://www.sephora.com/",
          "rights": "Reuse permission not yet documented"
        },
        {
          "name": "Ulta US bestsellers",
          "url": "https://www.ulta.com/",
          "rights": "Reuse permission not yet documented"
        }
      ],
      "market": "United States",
      "period": "2026-11"
    },
    "warning": "Initial data edition: US retailer bestseller observations only. Shares are model estimates, not measured sales or national market share. Missing categories and history are unavailable. Source reuse permissions remain under review; this is an initial limited-coverage edition."
  },
  "latestMonth": "2026-11",
  "months": [
    "2026-11"
  ],
  "mcp": "https://beauty.askbestie.me/mcp",
  "openapi": "https://beauty.askbestie.me/api/openapi.json",
  "endpoints": {
    "best": "https://beauty.askbestie.me/api/best/{slug}.json",
    "rankings": "https://beauty.askbestie.me/api/rankings/{slug}.json",
    "products": "https://beauty.askbestie.me/api/products.json",
    "trending": "https://beauty.askbestie.me/api/trending.json",
    "metaBuild": "https://beauty.askbestie.me/api/meta-build.json",
    "methodology": "https://beauty.askbestie.me/api/methodology.json"
  },
  "markets": {
    "na": "United States"
  },
  "attribution": "Please cite Ask Bestie Beauty (https://beauty.askbestie.me) and the data month when you use these figures.",
  "categories": [
    {
      "id": "foundation",
      "slug": "foundation",
      "name": "Foundation",
      "searchName": "foundation",
      "section": "Face",
      "available": true,
      "measure": "purchase",
      "shareOf": "purchases represented by observed retailer lists",
      "filters": [
        "finish=Matte",
        "finish=Dewy",
        "finish=Natural"
      ],
      "page": "https://beauty.askbestie.me/best/foundation/",
      "best": "https://beauty.askbestie.me/api/best/foundation.json",
      "rankings": "https://beauty.askbestie.me/api/rankings/foundation.json"
    },
    {
      "id": "concealer",
      "slug": "concealer",
      "name": "Concealer",
      "searchName": "concealer",
      "section": "Face",
      "available": true,
      "measure": "purchase",
      "shareOf": "purchases represented by observed retailer lists",
      "filters": [],
      "page": "https://beauty.askbestie.me/best/concealer/",
      "best": "https://beauty.askbestie.me/api/best/concealer.json",
      "rankings": "https://beauty.askbestie.me/api/rankings/concealer.json"
    },
    {
      "id": "blush",
      "slug": "blush",
      "name": "Blush",
      "searchName": "blush",
      "section": "Face",
      "available": true,
      "measure": "purchase",
      "shareOf": "purchases represented by observed retailer lists",
      "filters": [],
      "page": "https://beauty.askbestie.me/best/blush/",
      "best": "https://beauty.askbestie.me/api/best/blush.json",
      "rankings": "https://beauty.askbestie.me/api/rankings/blush.json"
    },
    {
      "id": "powder",
      "slug": "setting-powder",
      "name": "Setting Powder",
      "searchName": "setting powder",
      "section": "Face",
      "available": true,
      "measure": "purchase",
      "shareOf": "purchases represented by observed retailer lists",
      "filters": [],
      "page": "https://beauty.askbestie.me/best/setting-powder/",
      "best": "https://beauty.askbestie.me/api/best/setting-powder.json",
      "rankings": "https://beauty.askbestie.me/api/rankings/setting-powder.json"
    },
    {
      "id": "bronzer",
      "slug": "bronzer",
      "name": "Bronzer",
      "searchName": "bronzer",
      "section": "Face",
      "available": true,
      "measure": "purchase",
      "shareOf": "purchases represented by observed retailer lists",
      "filters": [],
      "page": "https://beauty.askbestie.me/best/bronzer/",
      "best": "https://beauty.askbestie.me/api/best/bronzer.json",
      "rankings": "https://beauty.askbestie.me/api/rankings/bronzer.json"
    },
    {
      "id": "mascara",
      "slug": "mascara",
      "name": "Mascara",
      "searchName": "mascara",
      "section": "Eyes",
      "available": true,
      "measure": "purchase",
      "shareOf": "purchases represented by observed retailer lists",
      "filters": [],
      "page": "https://beauty.askbestie.me/best/mascara/",
      "best": "https://beauty.askbestie.me/api/best/mascara.json",
      "rankings": "https://beauty.askbestie.me/api/rankings/mascara.json"
    },
    {
      "id": "eyeshadow",
      "slug": "eyeshadow-palette",
      "name": "Eyeshadow Palette",
      "searchName": "eyeshadow palette",
      "section": "Eyes",
      "available": false,
      "note": "Coming soon: no data for this category yet."
    },
    {
      "id": "eyeliner",
      "slug": "eyeliner",
      "name": "Eyeliner",
      "searchName": "eyeliner",
      "section": "Eyes",
      "available": false,
      "note": "Coming soon: no data for this category yet."
    },
    {
      "id": "brow",
      "slug": "brow",
      "name": "Brow",
      "searchName": "brow product",
      "section": "Eyes",
      "available": false,
      "note": "Coming soon: no data for this category yet."
    },
    {
      "id": "lipstick",
      "slug": "lipstick",
      "name": "Lipstick",
      "searchName": "lipstick",
      "section": "Lips",
      "available": true,
      "measure": "purchase",
      "shareOf": "purchases represented by observed retailer lists",
      "filters": [
        "finish=Matte",
        "finish=Satin",
        "finish=Sheer"
      ],
      "page": "https://beauty.askbestie.me/best/lipstick/",
      "best": "https://beauty.askbestie.me/api/best/lipstick.json",
      "rankings": "https://beauty.askbestie.me/api/rankings/lipstick.json"
    },
    {
      "id": "lipoil",
      "slug": "lip-oil",
      "name": "Lip Oil & Gloss",
      "searchName": "lip oil",
      "section": "Lips",
      "available": false,
      "note": "Coming soon: no data for this category yet."
    },
    {
      "id": "lipliner",
      "slug": "lip-liner",
      "name": "Lip Liner",
      "searchName": "lip liner",
      "section": "Lips",
      "available": false,
      "note": "Coming soon: no data for this category yet."
    },
    {
      "id": "primer",
      "slug": "primer",
      "name": "Primer",
      "searchName": "primer",
      "section": "Skin Prep",
      "available": false,
      "note": "Coming soon: no data for this category yet."
    },
    {
      "id": "settingspray",
      "slug": "setting-spray",
      "name": "Setting Spray",
      "searchName": "setting spray",
      "section": "Skin Prep",
      "available": false,
      "note": "Coming soon: no data for this category yet."
    },
    {
      "id": "tinted",
      "slug": "tinted-moisturiser",
      "name": "Tinted Moisturiser & SPF",
      "searchName": "tinted moisturiser",
      "section": "Skin Prep",
      "available": false,
      "note": "Coming soon: no data for this category yet."
    }
  ]
}