61of120
shippingTimeGuarantee omitted across product-detail API responses.
61 of 120 1688 toy product-detail API responses omitted shippingTimeGuarantee
We sampled 120 first-page toy results through 1688's English cross-border keyword API, then requested a product-detail response for each result. 59 responses returned productShippingInfo.shippingTimeGuarantee and 61 omitted it. The omission count varied across the twelve search terms.
Liam Cai · Founder, SupplymoYiwu, ChinaWhat we measured
shippingTimeGuarantee field return across 120 sampled 1688 toy product-detail API responses
This measures whether one product-detail API response returned a named field. It does not establish rendered-page content, supplier intent or performance, dispatch outcome, or toy safety.
It cannot establish what a rendered 1688 website, app, product description, other API surface or supplier conversation contained. The study queried one product-detail API response per sampled result.
Study reading
Omission varied by search term
water gun and slime kit each had nine omissions among ten product-detail API responses. building blocks and magnetic toys had at most two omissions among ten. The calls used the same API family, collection day and per-keyword denominator.
That contrast is a useful description of this sample, not an estimate for the whole toy category. The keywords were chosen deliberately and each split contains only ten responses, so the data cannot establish why the difference appeared or whether it persists over time.
Study reading
Returned values used two documented strings
Among the 59 product-detail API responses that contained shippingTimeGuarantee, 54 returned shipIn48Hours and 5 returned shipIn24Hours. No other value appeared in this sample.
The official 1688 response schema places shippingTimeGuarantee under productShippingInfo. This study records the returned key and value only. It does not test production completion, international transit, customs, destination delivery or performance on an actual order.
Study reading
How a buyer can use a response-level gap
When the sampled API response omitted shippingTimeGuarantee, that data source could not answer the dispatch-timing question. A buyer can close the gap by requesting a current written production and dispatch date tied to the exact product, variant, quantity and order terms before payment.
Keep the API observation and the supplier confirmation as separate evidence. One records what this response contained on 2026-08-12; the other records the commercial term agreed for a specific order. Neither should be substituted for the other.
Use this data
Everything here is free to reuse with attribution under CC BY 4.0. If you need a cut of the data we have not published, ask and we will run it.
Quote it, or take the whole file
One line, free to quote with attribution
In a Supplymo non-random sample of 120 first-page toy results from 1688's English cross-border keyword API, 61 product-detail API responses omitted productShippingInfo.shippingTimeGuarantee; the water gun and slime kit searches each had nine omissions among ten sampled responses.
How to cite this study
Liam Cai. "shippingTimeGuarantee field return across 1688 toy API responses." Supplymo, 18 August 2026, https://supplymo.com/research/1688-toy-listings.
One row per sampled product-detail API response. No supplier identity is published, and the sample was not de-duplicated by shop. 11 stated limits travel inside the file. Free to reuse with attribution under CC BY 4.0.
Method
How the sample was collected
Everything here is reproducible from the evidence file and the sampling script.
Source
com.alibaba.fenxiao.crossborder:product.search.keywordQuery + product.search.queryProductDetail (read-only)
Sampling frame
12 English toy keyword searches on the cross-border distribution channel, first API results page only, 10 platform-ranked product results per keyword. A product-detail API response was then requested for each result. The keyword list deliberately mixes safety-sensitive subcategories (water gun, toy gun, slime kit, magnetic toys, baby rattle) with ordinary ones (plush toy, building blocks, toy car, doll, puzzle toy, rc car, educational toy).
Collection window
Single day, 2026-08-12 in China
Write operations
None. No order, payment, enquiry, messaging or logistics endpoint was called.
Check the figures yourself
One row per sampled product-detail API response. No supplier identity is published, and the sample was not de-duplicated by shop.
- Rows
- 120
- Collected
- 2026-08-12
- Stated limits
- 11
Readings tested before publication+
What does omission of shippingTimeGuarantee establish?
Method. Record hasOwnProperty for productShippingInfo.shippingTimeGuarantee on every product-detail API response instead of converting an omitted key into a real-world commercial term.
Result. The product-detail API response returned shippingTimeGuarantee on 59 of 120 sampled rows and omitted it on 61.
Conclusion. Omission establishes only that this product-detail API response did not contain the key. It does not establish what a rendered 1688 page, another API surface or a supplier conversation showed.
Does an API-returned refund-rate value of exactly 0.0 mean no refunds, or does it mean no data?
Method. Compare the after-sales experience-score distributions for rows returning numeric zero and rows returning a value above zero as a descriptive ambiguity check. The direction cannot authenticate the platform field's definition, denominator, scope or missing-data convention.
Result. In this toy sample the direction test is inconclusive: API-response rows returning zero have a median after-sales score of 3.8, below the 4 of rows returning a value above zero — the opposite direction from the general-shelf sample.
Conclusion. Unlike the general-shelf study, we cannot rule out the missing-data reading here. The count is therefore published only as 'API responses returning a numeric zero', and no claim is made about actual refunds.
Can repeated refund-rate values establish whether the field is product- or merchant-scoped?
Method. Group the observed non-zero API-returned values and measure the largest repeated cluster.
Result. The largest repeated non-zero value covers 3 of 79 non-zero rows.
Conclusion. No. The public sample contains no seller identity, so repetition cannot resolve product-versus-merchant scope. The values are reported only as values returned for each sampled product-detail response.
Limits
The 11 limits of this sample
All 11 stated limitations, in the order the evidence file lists them. A number travels further than the caveat attached to it.
- 1This is not a random sample. Rows correspond to first-page English keyword API results ranked by the platform, so they cannot estimate field-return rates across all 1688 products, categories, dates or buyer interfaces.
- 2This study measures whether named keys and values were present in one product-detail API response. It does not establish what a rendered website, app, description, other API surface or supplier conversation contained.
- 3Per-keyword splits rest on 10 product-detail API responses each. Figures like 'nine out of ten' are descriptive of this draw only; no statistical test is applied and none would be meaningful at that size.
- 4The zero-refund-rate count is a count of API responses returning a numeric zero. The descriptive score comparison cannot establish the field's definition, denominator, scope or missing-data convention, so no claim is made about actual refunds. See the ambiguity checks.
Show the other 7 limits+
- 5We did not audit the formula, unit, denominator, missing-data convention or product-versus-merchant scope of qualityRefundWithin30Day.
- 6shippingTimeGuarantee is an API field under productShippingInfo. Its presence or omission does not establish production completion, international transit, customs, destination delivery, safety compliance or performance on an actual order.
- 7The keyword list was chosen deliberately, not sampled: it over-represents safety-sensitive toy subcategories on purpose. Shelf-wide averages in this file should not be read as an estimate for the whole toy category.
- 8Single day of collection. Platform fields can change, and no trend is claimed from one observation.
- 9All figures describe responses from the English cross-border distribution APIs. Other 1688 surfaces may return or present different information.
- 10Nothing here says a platform or seller has done anything wrong, and the result does not establish seller intent, policy or performance.
- 11The 120 rows are 120 sampled product results and product-detail API responses, not 120 distinct suppliers. We deliberately do not publish seller identity, so the sample cannot be de-duplicated by shop and one seller may appear more than once.
Research boundary
What this study cannot tell you
- It cannot establish what a rendered 1688 website, app, product description, other API surface or supplier conversation contained. The study queried one product-detail API response per sampled result.
- It cannot establish seller intent, policy or performance. A missing key is an API-response observation, not a conclusion about a supplier or an actual order.
- It is not a toy-safety assessment. The sample did not inspect materials, test reports, standards, age grading or destination-market requirements.
- The per-keyword figures use ten product-detail API responses each. Nine out of ten describes this non-random draw; it is not a category-wide prevalence estimate.
- The 120 rows are sampled product results and responses, not 120 distinct suppliers. Seller identity is not published, so the sample cannot be de-duplicated by shop.
- The 40 refund-rate values returned as numeric zero are not interpreted as zero actual refunds. The direction check was inconclusive, and the field's unit, denominator and missing-data convention were not independently verified.
What this means for a buyer
A sample of this kind is a starting point for questions, not a verdict on any one supplier. Check the exact product and supplier you are about to pay.

Supplier verification
A free check before you commit. We run supplier checks from Yiwu, and we do not promise a lowest price.
Check a supplier →Questions a reader should ask about this
What is the one-line finding?
In a Supplymo non-random sample of 120 first-page toy results from 1688's English cross-border keyword API, 61 product-detail API responses omitted productShippingInfo.shippingTimeGuarantee; the water gun and slime kit searches each had nine omissions among ten sampled responses. This is a response-level field-presence result collected on 2026-08-12, not a claim about any other 1688 surface or supplier conversation.
What does an omitted shippingTimeGuarantee key prove?
Only that productShippingInfo in the sampled product-detail API response did not contain shippingTimeGuarantee. We did not treat omission as evidence about a rendered website, app, description, other API surface, supplier terms or actual order performance.
Why did water gun and slime kit stand out?
Each search had nine omissions among ten sampled product-detail API responses, compared with at most two among ten for building blocks and magnetic toys. These are descriptive splits from one non-random draw; the sample does not establish a cause or estimate category-wide prevalence.
Does this result say anything about toy safety?
No. The sample did not inspect materials, test reports, standards, age grading or destination-market requirements. API-field presence and product safety are separate questions.
Can I reuse the figures?
Yes, with attribution to Supplymo and a link to this page. The sanitized row-level CSV and evidence JSON are published under CC BY 4.0, together with the method and every stated limit.
