API reference

The repsapi.pl reference

One base URL, bearer auth, predictable JSON. Every endpoint is live and free - grab a key and start calling.

https://repsapi.pl/v1Authorization: Bearer rk_live_…
On this pageTrackingQC PhotosItem LookupLink ConvertShippingSDKs

Tracking

GET/v1/tracking

Full-route tracking by the number your agent gave you: China scans, the flight, customs and the destination carrier - newest first, in Polish and English, with a stage code and a summary.

Parameters

numreqstring

The tracking number to look up (alias: id).

request
curl "https://repsapi.pl/v1/tracking?num=YT2530998211074512" \
  -H "Authorization: Bearer YOUR_KEY"
200 · response
{
  "tracking_number": "YT2530998211074512",
  "count": 3,
  "summary": {
    "stage": "flight_departed",
    "status": "Samolot z przesyłką wystartował",
    "status_en": "Flight departed",
    "delivered": false,
    "last_update": "2026-10-05 08:14:00",
    "origin_country": "CN",
    "destination_country": "PL",
    "carrier": null,
    "carrier_tracking_number": null,
    "estimated_delivery": {
      "from": "2026-10-12",
      "to": "2026-10-15",
      "based_on": 37,
      "from_stage": "flight_departed",
      "slower_than_usual": false
    }
  },
  "updates": [
    {
      "date": "2026-10-05",
      "hour": "08:14:00",
      "status": "Samolot z przesyłką wystartował",
      "status_en": "Flight departed",
      "status_original": "航班已起飞",
      "stage": "flight_departed",
      "location": "",
      "country": "CN"
    },
    {
      "date": "2026-10-04",
      "hour": "17:02:11",
      "status": "Zakończono odprawę eksportową w Chinach",
      "status_en": "Export customs clearance in China completed",
      "status_original": "出口清关完成",
      "stage": "export_customs",
      "location": "",
      "country": "CN"
    },
    {
      "date": "2026-10-02",
      "hour": "22:01:40",
      "status": "Przesyłka dotarła do magazynu spedytora",
      "status_en": "Arrived at the forwarder's warehouse",
      "status_original": "到达收货点",
      "stage": "received",
      "location": "Shenzhen",
      "country": "CN"
    }
  ],
  "source": "repsapi.pl",
  "attribution": "Data provided by repsapi.pl",
  "docs": "https://repsapi.pl/docs"
}

QC Photos

GET/v1/qc

Real warehouse QC photo batches by product link (or platform + id), grouped by run, plus the seller's listing photos. Photos are served as WebP from repsapi.pl.

Parameters

urlREQ · or platform + idstring

Any agent or raw platform product link.

platformstring

Alternative to url - weidian · taobao · 1688 · tmall.

idstring

Alternative to url - product id on the platform.

request
curl "https://repsapi.pl/v1/qc?url=https://weidian.com/item.html?itemID=7779617259" \
  -H "Authorization: Bearer YOUR_KEY"
200 · response
{
  "platform": "weidian",
  "product_id": "7779617259",
  "canonical": "https://weidian.com/item.html?itemID=7779617259",
  "provider": "warehouse-archive",
  "total_photos": 42,
  "batch_count": 8,
  "batches": [
    {
      "date": "2026-10-13",
      "photos": [
        "https://repsapi.pl/v1/photos/DBOc8Zm0Ib8v8b-e59K8eObcJ16Ro3hA08x2ug.webp",
        "https://repsapi.pl/v1/photos/2rX5BMjIhSAPQ_oEmlz3ayvU0BwRQzmkZMJiSA.webp",
        "…"
      ]
    },
    "…"
  ],
  "listing_photos": [
    "https://si.geilicdn.com/pcitem2071630321-0974000001a02647e7d70a21146b-unadjust_1536_1536.png",
    "…"
  ],
  "source": "repsapi.pl",
  "docs": "https://repsapi.pl/docs"
}

Item Lookup

GET/v1/lookup

One call returns title, gallery, price, stock, sizes and versions with the full SKU matrix - plus warehouse weight and dimensions, the seller and how many QC photos exist.

Parameters

urlREQ · or platform + idstring

Any agent or raw platform link. The agent it came from is auto-detected.

platformstring

Alternative to url - weidian · taobao · 1688 · tmall.

idstring

Alternative to url - product id on the platform.

agentstring

Optional - use this agent's warehouse data when we have an adapter for it.

currencystring

Optional - also return prices in this currency (PLN, EUR, USD…), converted at the official NBP rate.

request
curl "https://repsapi.pl/v1/lookup?url=https://detail.1688.com/offer/678091425228.html&currency=PLN" \
  -H "Authorization: Bearer YOUR_KEY"
200 · response
{
  "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"
}

Link Convert

GET/v1/convert

Convert any agent or raw marketplace link into links for every supported agent. One call, every agent.

Parameters

urlreqstring

Any agent or raw platform product link.

agentsstring[]

Restrict output to specific agents (default: all).

request
curl "https://repsapi.pl/v1/convert?url=https://www.acbuy.com/product?id=7779617259%26source=WD" \
  -H "Authorization: Bearer YOUR_KEY"
200 · response
{
  "platform": "weidian",
  "id": "7779617259",
  "canonical": "https://weidian.com/item.html?itemID=7779617259",
  "agents": {
    "kakobuy": "https://www.kakobuy.com/item/details?url=https%3A%2F%2Fweidian.com%2Fitem.html%3FitemID%3D7779617259",
    "cnfans": "https://cnfans.com/product?id=7779617259&platform=WEIDIAN&searchInfo=https%3A%2F%2Fweidian.com%2Fitem.html%3FitemID%3D7779617259",
    "acbuy": "https://www.acbuy.com/product?id=7779617259&source=WD",
    "mulebuy": "https://mulebuy.com/product?id=7779617259&platform=WEIDIAN&searchInfo=https%3A%2F%2Fweidian.com%2Fitem.html%3FitemID%3D7779617259",
    "hoobuy": "https://www.hoobuy.com/product/2/7779617259",
    "cssbuy": "https://www.cssbuy.com/item-micro-7779617259.html",
    "…": "15 agents in total"
  },
  "source": "repsapi.pl",
  "docs": "https://repsapi.pl/docs"
}

Shipping

GET/v1/shipping/estimate

Every shipping line from China to a country with its price, delivery time and what it accepts - by weight or straight from product links. POST /v1/haul prices a whole haul: goods, domestic shipping and shipping.

Parameters

countryreqstring

Destination, 2-letter code (PL, DE…). List: GET /v1/shipping/countries.

weightREQ · or urlnumber

Parcel weight in grams - or pass url instead.

urlstring[]

Up to 10 product links (repeat the parameter); weights and sizes come from lookup.

length/width/heightnumber

Optional box size in cm - all three together.

currencystring

Optional - adds price_local to every line.

brands/battery/liquids1

Optional - only lines that accept branded goods, batteries or liquids.

request
curl "https://repsapi.pl/v1/shipping/estimate?country=PL&weight=1000&length=35&width=25&height=12&currency=PLN" \
  -H "Authorization: Bearer YOUR_KEY"
200 · response
{
  "country": { "code": "PL", "name": "Poland" },
  "parcel": { "weight_g": 1000, "dimensions_cm": { "length": 35, "width": 25, "height": 12 } },
  "currency": "CNY",
  "exchange": { "from": "CNY", "to": "PLN", "rate": 0.5852, "date": "2026-10-13", "source": "NBP" },
  "lines": [
    {
      "id": "3612",
      "name": "Europe Tariffless Line (Actual Weight)",
      "days": { "min": 7, "max": 20 },
      "price": 199.9,
      "currency": "CNY",
      "price_local": 116.98,
      "chargeable_weight_g": 1000,
      "volumetric_divisor": null,
      "accepts": { "brands": true, "battery": false, "liquids": false },
      "…": "…"
    },
    "… 14 more lines, cheapest first"
  ],
  "cheapest": "3612",
  "fastest": "…",
  "source": "repsapi.pl",
  "docs": "https://repsapi.pl/docs/shipping"
}

SDKs

Official packages for JavaScript / TypeScript and Python: one method per endpoint, typed responses and automatic retries. Any HTTP client works too.

npm install repsapipip install repsapi
SDK guide →

Ready to build? Create a free account to get your API key.

Get API key