ShopItUp Developers v1

ShopItUp Shopping API

Shop new and previously loved fashion from independent Canadian stores

Search one-of-a-kind items across every store on ShopItUp, price an order with live shipping and tax, and hand the person a link to confirm and pay.

Every endpoint is live. Items, stores, categories, quotes, checkout links and account linking answer today. A change to the contract is published on Versions and changes before it ships.
Search items
curl -G "https://shopitup.ca/api/v1/products" \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "q=fleece pullover" \
  -d "size=S" \
  -d "max_price=150"
Response
{
  "data": [
    {
      "id": 5171,
      "title": "(S) Arc'teryx Casual Cozy Outdoor Gray Fleece Turtleneck Pullover",
      "brand": "Arc'teryx",
      "category": "Women > Sweaters > Cowl & Turtlenecks",
      "price": {
        "amount": "110.00",
        "currency": "CAD"
      },
      "sizes": [
        "S"
      ],
      "condition": "good",
      "available": true,
      "cover_image": {
        "url": "https://cdn.shopitup.ca/tenants/1/images/derivatives/w1600/6ab94b3ac3e92_image1.jpg",
        "is_cover": true
      },
      "url": "https://www.revisited.ca/product/5171",
      "store": {
        "slug": "revisited",
        "name": "Revisited",
        "url": "https://www.revisited.ca"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 24,
    "total": 1,
    "last_page": 1
  },
  "facets": {
    "brand": [
      {
        "value": "Arc'teryx",
        "count": 1
      }
    ],
    "size": [
      {
        "value": "S",
        "count": 1
      }
    ],
    "color": [
      {
        "value": "Gray",
        "count": 1
      }
    ],
    "category": [
      {
        "value": "Women",
        "count": 1
      },
      {
        "value": "Women > Sweaters > Cowl & Turtlenecks",
        "count": 1
      }
    ],
    "store": [
      {
        "value": "revisited",
        "count": 1
      }
    ]
  }
}

Get access

  1. Create an account

    A free ShopItUp account with a confirmed email address. Already have one? Sign in.

    Sign up →
  2. Apply in the portal

    Tell us what you are building and accept the Developer Terms. We review every application and email you.

    Developer portal →
  3. Collect your credentials

    Once approved, the portal shows your client id and your secret — once. Exchange them for a token and make your first call.

    Authentication →

Questions first? Write to [email protected].

How a purchase works

The agent never takes payment. The person always confirms and pays on ShopItUp's checkout, by card or Link.

  1. Find items

    Search every store at once by words, size, brand, condition and price.

    GET/products
  2. Price the order

    Send the items and an address. Get live shipping options and tax from each store.

    POST/checkout/quotes
  3. Hand over a checkout link

    Turn the quote into a secure link. The person reviews the order and pays there.

    POST/checkout/sessions
  4. Confirm the purchase

    Check the checkout until it is paid, then follow the order and its tracking.

    GET/checkout/sessions/{checkout_id}

Base URLs

EnvironmentURL
Productionhttps://shopitup.ca/api/v1
Sandbox — test stores and Stripe test mode; no real orders or paymentshttps://shopitupbeta.ca/api/v1

Endpoints

Good to know

Only what can be bought

Items are listed only from stores that can complete a purchase right now — open, able to take payment and able to ship. Sold items drop out of search.

Every item is one of a kind

Most items have a quantity of one, so availability changes quickly. It is checked again when an order is priced and when it is paid.

One checkout, several stores

An order can hold items from different stores. Each store ships its own parcel and has its own shipping options.

Canadian stores, Canadian dollars

Every item is from a Canadian store, priced in Canadian dollars (CAD), and ships to Canadian addresses.

Accounts are linked by the person

With the person's permission, an agent can see their orders and tracking and use their saved sizes. See Authentication.