{
  "schemaVersion": "supplymo-research-evidence/1",
  "studyId": "2026-09-02-1688-shelf-index-01",
  "evidenceVersion": 1,
  "collectedOn": "2026-08-31",
  "publishedOn": "2026-09-02",
  "citableSentence": "In a fixed, non-random Supplymo panel of 120 1688 product-detail records observed once daily from 2026-08-06 to 2026-08-31, the composite-service median across 3,119 returned score observations was 4.5/5; 1,291 of 3,119 logistics-score observations and 500 of 3,119 after-sales-score observations were below 3.5, while 0 of 3,120 daily observations were explicitly marked offer_not_returned by the collection contract.",
  "provenance": {
    "publisher": "Supplymo",
    "sourceAggregateFormat": "Private fixed-panel JSONL observations, sanitized to daily public aggregates",
    "sourceWindowSha256": "d4aa76cf8dd2f5e3a7cbe8e5398e036210002a4879fb9fea90b5aa73275c8f2a",
    "sourceFile": "docs/growth-runs/assets/panel/observations.jsonl",
    "panelFile": "docs/growth-runs/assets/panel/panel-members.json",
    "samplingScript": "scripts/research/sample-1688-score-panel.mjs",
    "evidenceBuilder": "scripts/research/build-shelf-index-evidence.mjs",
    "sanitization": "Public rows contain daily counts and score distributions only. Offer IDs, seller IDs, shop names, company names, titles, URLs, prices, images, credentials and raw messages are not published.",
    "namedAuthor": "Liam Cai",
    "namedReviewer": null,
    "figureVerification": "Every published figure was deterministically recomputed from the sanitized daily rows and checked against the private source-window hash. No independent human reviewer is claimed.",
    "attributionNote": "Liam Cai is the named author. The figures are machine-recomputed from a fixed panel; no independent human review is claimed."
  },
  "methodology": {
    "sourceApi": "com.alibaba.fenxiao.crossborder:product.search.queryProductDetail (read-only)",
    "platform": "1688, the domestic Chinese wholesale marketplace",
    "samplingFrame": "A fixed panel selected on 2026-08-06 from the first ten platform-ranked rows for each of 12 deliberately selected English searches. The same 120 offer IDs were queried once per calendar day in this issue window.",
    "observationUnit": "One public row is one calendar day's aggregate across the fixed 120-item panel; it is not one supplier, one order, one shipment or one unique marketplace listing.",
    "collectionWindow": "2026-08-06 through 2026-08-31, Asia/Shanghai calendar days; one completed panel run per day.",
    "thresholdDefinition": "Below 3.5 means a numeric score strictly less than 3.5; it is a descriptive cut, not a supplier pass/fail rule.",
    "availabilityDefinition": "notReturnedRows counts only explicit offer_not_returned responses. A missing API return is not proof that a listing was deleted, a supplier stopped trading or a product was unavailable to every buyer.",
    "writeOperations": "None. No order, payment, enquiry, messaging, refund or logistics write endpoint was called.",
    "keywords": [
      "storage box",
      "phone case",
      "kids toy",
      "led lamp",
      "tote bag",
      "ceramic mug",
      "hair clip",
      "pet bed",
      "kitchen utensil",
      "desk lamp",
      "silk scarf",
      "keychain"
    ],
    "officialSources": [
      {
        "name": "1688 Open Platform — multilingual keyword search API",
        "url": "https://open.1688.com/api/apidocdetail.htm?id=com.alibaba.fenxiao.crossborder%3Aproduct.search.keywordQuery-1",
        "usedFor": "The one-time selection of the fixed panel on 2026-08-06.",
        "supports": "The official request schema defines keyword, page and locale inputs. It does not make the selected first-page rows random or representative.",
        "boundary": "The API documentation defines returned fields; it does not endorse this study or verify a supplier."
      },
      {
        "name": "1688 Open Platform — multilingual product-detail API",
        "url": "https://open.1688.com/api/apidocdetail.htm?id=com.alibaba.fenxiao.crossborder%3Aproduct.search.queryProductDetail-1",
        "usedFor": "Daily score-field and explicit offer-return observations for the fixed panel.",
        "supports": "The response schema defines the platform fields read by the panel.",
        "boundary": "Returned display fields are not audited fulfilment, supplier quality, order acceptance or future availability."
      }
    ],
    "fieldDictionary": {
      "day": "Asia/Shanghai calendar date of the completed 120-item panel run.",
      "panelMemberCount": "Number of fixed panel members expected that day; a structural count.",
      "observationRows": "Number of private item observations aggregated into this daily public row.",
      "returnedRows": "Rows normalized as returned by the product-detail API.",
      "notReturnedRows": "Rows explicitly marked offer_not_returned; not proof of permanent delisting.",
      "collectionErrorRows": "Rows where collection failed; excluded from the availability denominator.",
      "compositeScoreRows": "Returned rows with a numeric compositeServiceScore.",
      "compositeScoreDistribution": "Exact numeric compositeServiceScore values mapped to their daily observation counts.",
      "logisticsScoreRows": "Returned rows with a numeric logisticsExperienceScore.",
      "logisticsBelowThresholdRows": "Daily logistics score observations strictly below 3.5.",
      "afterSalesScoreRows": "Returned rows with a numeric afterSalesExperienceScore.",
      "afterSalesBelowThresholdRows": "Daily after-sales score observations strictly below 3.5."
    }
  },
  "summary": {
    "issueNumber": 1,
    "windowStart": "2026-08-06",
    "windowEnd": "2026-08-31",
    "dailyRowCount": 26,
    "panelMemberCount": 120,
    "rawObservationRowCount": 3120,
    "returnedObservationRows": 3120,
    "collectionErrorRows": 0,
    "confirmedNotReturnedRows": 0,
    "confirmedNotReturnedObservationShare": 0,
    "compositeScoreRows": 3119,
    "compositeScoreMedian": 4.5,
    "compositeScoreDistribution": {
      "0": 5,
      "4": 1107,
      "5": 391,
      "3.5": 252,
      "4.5": 1364
    },
    "scoreThreshold": 3.5,
    "logisticsScoreRows": 3119,
    "logisticsBelowThresholdRows": 1291,
    "logisticsBelowThresholdShare": 0.4139,
    "afterSalesScoreRows": 3119,
    "afterSalesBelowThresholdRows": 500,
    "afterSalesBelowThresholdShare": 0.1603
  },
  "limitations": [
    "This is a fixed, non-random panel selected from the first page of 12 deliberately chosen English searches; it is not representative of all 1688 listings.",
    "The 120 panel items were not de-duplicated by seller. They are not 120 distinct suppliers, factories, companies or ownership groups.",
    "The 3,120 private observations repeatedly measure the same 120 panel items across 26 days; they are not that many unique products.",
    "Scores are numeric fields returned by the platform. They are not independently audited service performance, warehouse evidence or buyer outcomes.",
    "The 3.5 threshold is a descriptive comparison point chosen before calculation. It is not a supplier approval rule.",
    "An explicit offer_not_returned response is not proof of permanent delisting, stockout, business closure or unavailability to every buyer.",
    "Collection errors are kept separate from explicit non-returns and never counted as unavailable.",
    "A returned product-detail row can still omit one or more score fields; score denominators therefore travel with every figure.",
    "No order, checkout, payment, supplier contact, message, shipment or after-sales case was observed.",
    "Nothing here says 1688, a platform operator or any seller has done anything wrong."
  ],
  "issues": [
    {
      "issueNumber": 1,
      "label": "Issue 1",
      "windowStart": "2026-08-06",
      "windowEnd": "2026-08-31",
      "publishedOn": "2026-09-02",
      "dailyRows": 26,
      "rawObservationRows": 3120
    }
  ],
  "rows": [
    {
      "day": "2026-08-06",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "4": 43,
        "5": 16,
        "3.5": 14,
        "4.5": 47
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 49,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 18
    },
    {
      "day": "2026-08-07",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "4": 40,
        "5": 15,
        "3.5": 14,
        "4.5": 51
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 50,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 15
    },
    {
      "day": "2026-08-08",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 119,
      "compositeScoreDistribution": {
        "4": 40,
        "5": 15,
        "3.5": 14,
        "4.5": 50
      },
      "logisticsScoreRows": 119,
      "logisticsBelowThresholdRows": 50,
      "afterSalesScoreRows": 119,
      "afterSalesBelowThresholdRows": 15
    },
    {
      "day": "2026-08-09",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "4": 43,
        "5": 16,
        "3.5": 12,
        "4.5": 49
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 49,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 16
    },
    {
      "day": "2026-08-10",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "4": 42,
        "5": 16,
        "3.5": 11,
        "4.5": 51
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 49,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 16
    },
    {
      "day": "2026-08-11",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "4": 42,
        "5": 16,
        "3.5": 11,
        "4.5": 51
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 50,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 18
    },
    {
      "day": "2026-08-12",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "4": 44,
        "5": 16,
        "3.5": 11,
        "4.5": 49
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 51,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 19
    },
    {
      "day": "2026-08-13",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "4": 44,
        "5": 16,
        "3.5": 11,
        "4.5": 49
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 51,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 19
    },
    {
      "day": "2026-08-14",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "4": 45,
        "5": 16,
        "3.5": 12,
        "4.5": 47
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 51,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 18
    },
    {
      "day": "2026-08-15",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "4": 53,
        "5": 14,
        "3.5": 9,
        "4.5": 44
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 51,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 17
    },
    {
      "day": "2026-08-16",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "4": 52,
        "5": 14,
        "3.5": 9,
        "4.5": 45
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 51,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 17
    },
    {
      "day": "2026-08-17",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "4": 44,
        "5": 14,
        "3.5": 9,
        "4.5": 53
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 50,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 18
    },
    {
      "day": "2026-08-18",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "4": 44,
        "5": 14,
        "3.5": 9,
        "4.5": 53
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 50,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 18
    },
    {
      "day": "2026-08-19",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "4": 41,
        "5": 13,
        "3.5": 9,
        "4.5": 57
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 49,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 19
    },
    {
      "day": "2026-08-20",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "4": 40,
        "5": 13,
        "3.5": 9,
        "4.5": 58
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 50,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 19
    },
    {
      "day": "2026-08-21",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "4": 41,
        "5": 15,
        "3.5": 9,
        "4.5": 55
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 49,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 21
    },
    {
      "day": "2026-08-22",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "4": 41,
        "5": 15,
        "3.5": 9,
        "4.5": 55
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 49,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 21
    },
    {
      "day": "2026-08-23",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "4": 36,
        "5": 16,
        "3.5": 11,
        "4.5": 57
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 50,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 21
    },
    {
      "day": "2026-08-24",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "4": 37,
        "5": 15,
        "3.5": 9,
        "4.5": 59
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 51,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 22
    },
    {
      "day": "2026-08-25",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "4": 43,
        "5": 18,
        "3.5": 7,
        "4.5": 52
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 49,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 22
    },
    {
      "day": "2026-08-26",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "4": 42,
        "5": 13,
        "3.5": 8,
        "4.5": 57
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 45,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 21
    },
    {
      "day": "2026-08-27",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "0": 1,
        "4": 41,
        "5": 15,
        "3.5": 8,
        "4.5": 55
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 48,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 22
    },
    {
      "day": "2026-08-28",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "0": 1,
        "4": 42,
        "5": 13,
        "3.5": 8,
        "4.5": 56
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 50,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 23
    },
    {
      "day": "2026-08-29",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "0": 1,
        "4": 43,
        "5": 16,
        "3.5": 7,
        "4.5": 53
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 48,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 22
    },
    {
      "day": "2026-08-30",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "0": 1,
        "4": 45,
        "5": 16,
        "3.5": 4,
        "4.5": 54
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 49,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 21
    },
    {
      "day": "2026-08-31",
      "panelMemberCount": 120,
      "observationRows": 120,
      "returnedRows": 120,
      "notReturnedRows": 0,
      "collectionErrorRows": 0,
      "compositeScoreRows": 120,
      "compositeScoreDistribution": {
        "0": 1,
        "4": 39,
        "5": 15,
        "3.5": 8,
        "4.5": 57
      },
      "logisticsScoreRows": 120,
      "logisticsBelowThresholdRows": 52,
      "afterSalesScoreRows": 120,
      "afterSalesBelowThresholdRows": 22
    }
  ]
}