Item Lookup

Everything about a product in one call - title, gallery, price, live stock, sizes, versions and every SKU, plus measured weight and dimensions from an agent warehouse.

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. Or pass platform + id directly and an optional agent.

Parameters

Example

curl "https://repsapi.pl/v1/lookup?url=https://detail.1688.com/offer/678091425228.html&currency=PLN" \
  -H "Authorization: Bearer YOUR_KEY"

{
  "platform": "1688",
  "product_id": "678091425228",
  "canonical": "https://detail.1688.com/offer/678091425228.html",
  "source_agent": null,
  "title": "欧美高街潮牌360g摇粒绒加绒基础款连帽卫衣hoodies帽衫",
  "title_en": "European and American High Street Trendy Brand 360g Fleece Lined Basic Hoodie",
  "title_pl": "Europejska i amerykańska marka mody high street 360g polaru plus aksamitna podstawowa bluza z kapturem, bluza z kapturem",
  "main_image": "https://cbu01.alicdn.com/img/ibank/O1CN016JZaME1YMCbGFfudX_!!2911203044-0-cib.jpg",
  "images": ["https://cbu01.alicdn.com/img/ibank/O1CN016JZaME1YMCbGFfudX_!!2911203044-0-cib.jpg", "…"],
  "price": { "low": 65, "high": 73, "discount_low": null, "discount_high": null, "currency": "CNY" },
  "domestic_shipping": { "price": 8, "currency": "CNY" },
  "exchange": { "from": "CNY", "to": "PLN", "rate": 0.5852, "date": "2026-10-13", "source": "NBP" },
  "price_local": { "low": 38.04, "high": 42.72, "discount_low": null, "discount_high": null, "currency": "PLN" },
  "domestic_shipping_local": { "price": 4.68, "currency": "PLN" },
  "min_order": 1,
  "seller": { "id": "2911203044", "name": "外贸嘻哈商行" },
  "availability": { "in_stock": true, "total_stock": 40372 },
  "variant_source": "1688",
  "sizes": ["S", "M", "L", "XL", "XXL", "XXXL"],
  "versions": ["Black", "White", "Dark gray", "dark blue", "…38 colours"],
  "variants": {
    "options": [
      { "name": "Version", "name_cn": "Color", "values": ["Black", "White", "…"],
        "values_pl": ["Czarny", "Biały", "…"],
        "images": { "Black": "https://cbu01.alicdn.com/img/ibank/O1CN01fdC3m31YMCOIe7RY6_!!2911203044-0-cib.jpg", "…": "…" } },
      { "name": "Size", "name_cn": "Size", "values": ["S", "M", "L", "XL", "XXL", "XXXL"] }
    ],
    "skus": [
      { "attrs": { "Version": "Black", "Size": "S" }, "stock": 146, "price": 73, "price_local": 42.72,
        "image": "https://cbu01.alicdn.com/img/ibank/O1CN01fdC3m31YMCOIe7RY6_!!2911203044-0-cib.jpg" },
      "… 228 combinations"
    ]
  },
  "warehouse": {
    "storage_time": { "label": "Average storage time", "value": "2 days" },
    "turnover": null,
    "weight_g": 710,
    "volume_cm3": 7888,
    "dimensions_cm": "34×29×8 cm"
  },
  "category": "hoodie",
  "weight_estimate": null,
  "qc": { "batches": 10, "photos": 41 },
  "price_history": [
    { "date": "2026-10-10", "low": 65, "high": 73 },
    { "date": "2026-10-13", "low": 65, "high": 73 }
  ],
  "source": "repsapi.pl",
  "docs": "https://repsapi.pl/docs"
}

Where the data comes from

• Variants (sizes, versions, variants) come from the marketplace first - Weidian returns the full SKU graph (per-variant stock, price, image) with no login. An agent's copy of the listing fills in whatever the marketplace page hides: the full SKU matrix for 1688, Taobao and Tmall, English translations of the title and option values, the gallery and the seller. variant_source tells you which platform the variants describe.
• Warehouse stats (weight_g, volume_cm3, dimensions_cm, storage_time) are real numbers measured in an agent warehouse. The whole warehouse object is null when the item has never been measured.

Response

• title / title_en - the original title and an English one when a translation exists (otherwise null).
• title_pl - a Polish machine translation of the title, or null.
• main_image / images - the main photo and the listing gallery (up to 20).
• price - low / high (and discounted prices where the platform has them) in CNY.
• domestic_shipping - the seller's shipping fee to the agent warehouse ({ price, currency }) or null.
• min_order - minimum order quantity on 1688 wholesale listings, otherwise null.
• seller - { id, name } of the shop, or null.
• availability - in_stock (true / false, or null when the stock is unknown) and total_stock.
• sizes / versions - flat lists pulled from the variants.
• variants.options[] - each attribute group with name, original name_cn, values, optional values_en and values_pl (English / Polish, same order; sizes and numbers stay as they are) and images (photo per value).
• variants.skus[] - every combination with its attrs, stock, price and image.
• warehouse - weight_g, volume_cm3, dimensions_cm (L×W×H), storage_time; turnover is reserved and currently always null.
• category - our guess at what the item is (hoodie, sneakers, bag…) from its title, or null.
• weight_estimate - when no warehouse has measured the item: { grams, category, source, based_on }. source is similar_items (median of items we measured) or typical (a typical weight for the category). null when the weight is measured or the category unknown.
• price_history - one point per day we saw the item in the last 90 days, oldest first: { date, low, high } in CNY. It starts the first day anyone looks the item up.
• qc - how much QC exists for this item: batches and photos (fetch them with /v1/qc), or null if it couldn't be counted in time.
• source_agent - the agent detected from the link (null for marketplace links).
• note - present when no variant data could be found.

Prices in your currency

Add currency=PLN (or EUR, USD, GBP, CZK… - any 3-letter code the National Bank of Poland publishes) and the response gains converted copies of every price. The original CNY fields never change, so existing integrations keep working.

• exchange - { from, to, rate, date, source }: the official NBP mid rate used (ECB as a fallback), refreshed every few hours.
• price_local - price converted, with currency set to your code.
• domestic_shipping_local - the seller's shipping fee converted.
• variants.skus[].price_local - every SKU price converted.

An unknown code returns 400 with the list of supported currencies. If no rate source is reachable the lookup still answers, with exchange: null. The rates themselves are public:

curl "https://repsapi.pl/v1/rates?base=CNY"

{ "base": "CNY", "date": "2026-10-13", "source": "NBP",
  "rates": { "EUR": 0.133589, "PLN": 0.5852, "USD": 0.149373, "…": "…" } }

Notes

• Each source is isolated: a blocked marketplace or a slow source nulls only its own fields, never the whole response.
• Variant data is richest for Weidian and 1688 items; Taobao / Tmall depend on an agent having the listing.
• Results are cached for a few hours, so repeat lookups of the same item are fast, whichever agent link you pass.