Item Lookup

Everything about a product in one call — available sizes, versions/colorways, price and live stock, plus the warehouse stats from the agent the link came from.

Paste any agent or marketplace link as url (ACBuy, CNFans, KakoBuy, Weidian, Taobao, 1688, Tmall…). We detect the platform + product id and remember which agent it came from, then resolve two layers in parallel. Or pass platform + id directly and an optional agent.

Parameters

Example

curl "https://repsapi.com/v1/lookup?url=https://www.acbuy.com/product?id=7773938334&source=WD" \
  -H "Authorization: Bearer YOUR_KEY"

{
  "platform": "weidian",
  "product_id": "7773938334",
  "canonical": "https://weidian.com/item.html?itemID=7773938334",
  "source_agent": "acbuy",
  "title": "手工喷绘帆布鞋",
  "main_image": "https://si.geilicdn.com/…_800_800.jpg",
  "price": { "low": 225, "high": 275, "currency": "CNY" },
  "availability": { "in_stock": true, "total_stock": 141484 },
  "variant_source": "weidian",
  "sizes": ["36","37","38","39","40","41","42","43","44","45","46","47"],
  "versions": ["黑印花","黑粉破洞","全白"],
  "variants": {
    "options": [
      { "name": "Version", "name_cn": "颜色", "values": ["黑印花","全白"] },
      { "name": "Size",    "name_cn": "尺码", "values": ["36","42","47"] }
    ],
    "skus": [
      { "attrs": { "Version": "黑印花", "Size": "42" },
        "stock": 500, "price": 225,
        "image": "https://si.geilicdn.com/…jpg" }
    ]
  },
  "warehouse": {
    "agent": "acbuy",
    "storage_time": { "label": "Average storage time", "value": "2 days" },
    "turnover": null,
    "weight_g": 540,
    "volume_cm3": 6732,
    "dimensions_cm": "34×33×6 cm"
  },
  "source": "repsapi.com",
  "docs": "https://repsapi.com/docs"
}

Two data layers

• Variants (sizes, versions, variants) are the priority and come from the marketplace — the source of truth. Weidian returns the full SKU graph (per-variant stock, price, image) with no login; variant_sourcetells you where they came from. Taobao / 1688 / Tmall block server-side SKU reads, so for those pass the item's Weidian link for full variants.
• Warehouse stats (weight_g, volume_cm3, dimensions_cm, storage_time, turnover) are an optional bonus layer from the agentthe link came from — real numbers measured by that agent's warehouse. The whole warehouse object is null when the agent has nothing for the item, and never blocks the variant data.

Response

• title / main_image / price — product summary (price in the marketplace currency).
• variant_source — which platform the variants came from (null if none resolved).
• sizes / versions — flat convenience lists pulled from the SKU graph.
• variants.options[] — each attribute group with its name, original name_cn and values.
• variants.skus[] — every combination with its attrs, stock, price and image.
• availability — in_stock + total_stock.
• warehouse — agent plus weight_g, volume_cm3, dimensions_cm (L×W×H), storage_time and turnover (any field may be null if the agent hasn't measured the item yet).
• source_agent — the agent detected from the link (null for raw marketplace links).

Notes

• Each source is failure-isolated: a blocked marketplace or an unconfigured agent nulls only its own fields, never the whole response.
• Variant data is richest for Weidian items; pass a Weidian link (or convert to one) for full SKU detail.
• Warehouse stats are only as good as the source agent — ACBuy is the most complete for weight, volume and storage time.