Documentation

Build with repsapi

APIs for the reps ecosystem - parcel tracking, QC photos, item lookup and a universal agent link converter. One base URL, bearer auth, predictable JSON.

Base URL

All requests go to a single host. Every endpoint is versioned under /v1.

base url
https://repsapi.pl/v1

Quickstart

Create a free account to get an API key, then call the REST API directly - every request is a plain HTTPS call with your key in the Authorization header. Most endpoints are a GET; /v1/haul is a POST with a JSON body.

Product links carry their own ? and &, so URL-encode a link you pass as a parameter - curl -G --data-urlencode does it for you:

terminal
# convert any agent link → every other agent
curl -G "https://repsapi.pl/v1/convert" \
  --data-urlencode "url=https://www.acbuy.com/product?id=7283641902&source=WD" \
  -H "Authorization: Bearer YOUR_KEY"

What you can build

  • Tracking - the full route of an agent parcel, China to your door, in Polish and English.
  • QC Photos - real warehouse QC batches by product link or id, served as WebP.
  • Convert - turn any agent link into links for every other agent.
  • Item Lookup - gallery, price, stock, sizes, versions, SKUs, weight and seller in one call.
  • Shipping & haul - /v1/shipping/estimate and /v1/haul: shipping lines and a full haul total for any country.
  • Usage - GET /v1/usage shows your plan, today's usage and what's left.
  • Status - GET /v1/health (no key) shows whether every service is up.
  • Rates - GET /v1/rates (no key): the exchange rates behind ?currency=.
  • Changelog - GET /v1/changelog (no key) or the RSS feed: what's new.

Next steps

Head to Authentication to set up your key, then jump into the Tracking, QC, Convert, Item Lookup or Shipping & haul endpoints. Want to see the response shapes first? Every endpoint page has a real example, and the dashboard has a playground that calls the API with your key.