Independent source guide

Taobao listing data: item options, prices and search context

Compare Taobao item offers by selected options, price conditions, seller context and dated search position. Review current automated-access terms before collecting data.

Match a Taobao item by its selected specifications, not only its title

Taobao's platform agreement tells buyers to check product name, price, quantity, model, specifications and dimensions before ordering. Keep the source page and the exact option state together so similar titles do not become false matches.

Scroll to compare →

Match a Taobao item by its selected specifications, not only its title
Record elementPreserve from the sourceComparison rule
Item referenceTaobao item URL and any item identifier visibly supplied by the page or an authorized documented interfaceDo not assume a title alone identifies one stable offer.
Seller contextShop name or source shop reference as displayed with the itemKeep seller offers distinct even when product descriptions look alike.
Selected optionModel, specification, size, and the visible combination of selected optionsCompare the same configuration; an unselected page may describe several distinct offers.
Observation contextPage type, selected quantity/options and capture timestampDo not merge a search-result preview with a selected item-page state.

Keep a displayed amount tied to its option and promotion conditions

Record what the page displayed and the state in which it appeared. An amount shown before options are selected is not evidence that every option costs the same; a promotion shown on a listing is not proof of a buyer's checkout total or eligibility.

Scroll to compare →

Keep a displayed amount tied to its option and promotion conditions
Price observationContext to keepWhat it does not establish
Displayed amount or rangeExact page state, selected option if any, visible label, source currency and observation timeA range or preview is not a per-option price map.
Conditional promotionVisible threshold or condition text and the item/option to which it appears to applyEligibility, coupon availability and final paid amount for a particular buyer.
Quantity and specificationSelected quantity and the model/specification/dimensions shown on the pageA comparable unit price unless the quantity basis is clear.
Delivery or other chargesOnly values explicitly displayed for a known destination and page stateA universal delivered cost or a stable shipping charge.

Treat Taobao search position as a dated, multi-factor result

Taobao's seller-service agreement says display and search ordering may reflect price, sales, inventory, reputation, brand, service, compliance, user preferences, search habits and competitiveness. A captured position describes one query and time, not a direct sales count or a stable popularity score.

Scroll to compare →

Treat Taobao search position as a dated, multi-factor result
Search evidencePreserveInterpretation limit
Query and filtersSearch text, selected filters and result pageDifferent query/filter states are not comparable snapshots.
PositionDisplayed result position and capture timestampRank is influenced by multiple factors; it is not itself a sales or conversion measure.
Offer stateVisible item, selected specification and seller contextA position change can reflect changed results or context, not just demand.
CoveragePages/results actually observed and any skipped or unavailable resultsA partial capture does not describe the whole Taobao assortment.

Check current permission before automated Taobao access

Taobao's Legal Statement, effective 7 October 2026, restricts unauthorized acquisition or use through robots, crawlers, automated programs/devices and simulated user operations. It separately states that third-party automated programs may not access, call or operate Taobao services without prior explicit written permission and a security/compliance assessment. Review the posted terms and the permission that applies to the specific source and workflow.

Scroll to compare →

Check current permission before automated Taobao access
Information scopeUse this distinctionRecord boundary
Public item/search displayA page observation can describe only what was visible in that public page state and time.Do not imply automated collection is permitted by public visibility alone.
Official interface or APIUse only interface documentation and permissions applicable to the specific app and data scope.No Taobao endpoint or response schema is asserted here.
Buyer or seller account dataOrders, actual payments, contact/delivery details, carts, saved items, buyer-specific coupons and seller workbench records are account/transaction context.Keep private account records out of public listing observations; use them only within the account owner's authorized scope.

Content reviewed 2026-10-07.