Direct access to product metadata enables real-time synchronization across retail ecosystems. Developers can query comprehensive item attributes, including inventory states, pricing tiers, media assets, and vendor profiles, through standardized endpoint calls.

Request Configuration: The proxy service utilizes a query-string routing scheme to fetch catalog data. Target identifiers must correspond to the native SKU keys maintained by each marketplace.

GET /api/v1/catalog/items?source=taobao&id=8842901357&resolve_promotional_rates=true HTTP/1.1
Host: integration.example.com
Accept: application/json

Parameter Definitions:

• source: Identifies the target marketplace ecosystem. Acceptable values include taobao, jd, 1688, pinduoduo.
• id: The unique alphanumeric key assigned by the original vendor to the specific product listing.
• resolve_promotional_rates: Boolean toggle (true/false) directing the middleware to calculate dynamic pricing models, flash sale discounts, and membership tier reductions.

Response Payload Schema: The service returns a normalized JSON object. Legacy field names are mapped to consistent naming conventions to simplify frontend parsing.

{
  "status": 200,
  "payload": {
    "external_reference": "8842901357",
    "product_title": "Compact Multi-Tool Pocket Knife with Bottle Opener Integration",
    "summary_snippet": "",
    "pricing_details": {
      "active_rate": 25.80,
      "base_list_price": 25.80,
      "discount_value": 0,
      "recommended_retail": 0
    },
    "merchant_info": {
      "store_handle": "Official_Vendor_Flagship",
      "cumulative_sales": 832,
      "order_minimum": 0
    },
    "resource_urls": {
      "canonical_listing": "https://item.taobao.com/item.htm?id=8842901357",
      "hero_image": "https://img.alicdn.com/imgextra/i4/sample/pocket-knife.jpg"
    },
    "taxonomy": {
      "brand_label": "Sanrenmu",
      "brand_registry_uid": "4036703",
      "primary_category_id": "50013886",
      "subcategory_id": "50014822"
    },
    "engagement_data": {
      "save_count": 4824,
      "account_followers": 1469
    },
    "description_html": "<p style=\"text-align:center;\"><strong>Custom engraving available upon request. Contact support prior to checkout.</strong></p><p>Summer essential: compact folding blade integrated with a bottle opener. Ideal for outdoor activities and daily carry.</p><p>Enhanced chain accessory included at no additional cost to improve durability.</p>",
    "lifecycle_timestamps": {
      "creation_date": null,
      "last_revision": null,
      "deletion_schedule": null
    }
  },
  "error_codes": []
}

Data Normalization Guidelines: Cross-retailer APIs frequently return disjointed schemas. This abstraction layer converts platform-specific database keys into uniform external_reference formats. HTML description blocks are sanitized to strip inline event handlers before rendering in client applications. Pricing aggregation logic combines base costs, applicable coupons, and shipping fees to produce the final active_rate. Request throughput is governed by authentication tokan quotas; exceeding operational limits triggers HTTP 429 status codes, necessitating exponential backoff implementation.