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 →
| Record element | Preserve from the source | Comparison rule |
|---|---|---|
| Item reference | Taobao item URL and any item identifier visibly supplied by the page or an authorized documented interface | Do not assume a title alone identifies one stable offer. |
| Seller context | Shop name or source shop reference as displayed with the item | Keep seller offers distinct even when product descriptions look alike. |
| Selected option | Model, specification, size, and the visible combination of selected options | Compare the same configuration; an unselected page may describe several distinct offers. |
| Observation context | Page type, selected quantity/options and capture timestamp | Do 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 →
| Price observation | Context to keep | What it does not establish |
|---|---|---|
| Displayed amount or range | Exact page state, selected option if any, visible label, source currency and observation time | A range or preview is not a per-option price map. |
| Conditional promotion | Visible threshold or condition text and the item/option to which it appears to apply | Eligibility, coupon availability and final paid amount for a particular buyer. |
| Quantity and specification | Selected quantity and the model/specification/dimensions shown on the page | A comparable unit price unless the quantity basis is clear. |
| Delivery or other charges | Only values explicitly displayed for a known destination and page state | A 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 →
| Search evidence | Preserve | Interpretation limit |
|---|---|---|
| Query and filters | Search text, selected filters and result page | Different query/filter states are not comparable snapshots. |
| Position | Displayed result position and capture timestamp | Rank is influenced by multiple factors; it is not itself a sales or conversion measure. |
| Offer state | Visible item, selected specification and seller context | A position change can reflect changed results or context, not just demand. |
| Coverage | Pages/results actually observed and any skipped or unavailable results | A 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 →
| Information scope | Use this distinction | Record boundary |
|---|---|---|
| Public item/search display | A 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 API | Use 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 data | Orders, 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.