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.
curl -G "https://shopitup.ca/api/v1/products" \
-H "Authorization: Bearer $TOKEN" \
--data-urlencode "q=fleece pullover" \
-d "size=S" \
-d "max_price=150"
const response = await fetch("https://shopitup.ca/api/v1/products?q=fleece+pullover&size=S&max_price=150", {
headers: {
Authorization: `Bearer ${token}`,
},
});
const data = await response.json();
import requests
response = requests.get(
"https://shopitup.ca/api/v1/products",
params={
"q": "fleece pullover",
"size": ["S"],
"max_price": 150,
},
headers={"Authorization": f"Bearer {token}"},
)
data = response.json()
{
"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
-
Create an account
A free ShopItUp account with a confirmed email address. Already have one? Sign in.
Sign up → -
Apply in the portal
Tell us what you are building and accept the Developer Terms. We review every application and email you.
Developer portal → -
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.
-
Find items
Search every store at once by words, size, brand, condition and price.
GET/products -
Price the order
Send the items and an address. Get live shipping options and tax from each store.
POST/checkout/quotes -
Hand over a checkout link
Turn the quote into a secure link. The person reviews the order and pays there.
POST/checkout/sessions -
Confirm the purchase
Check the checkout until it is paid, then follow the order and its tracking.
GET/checkout/sessions/{checkout_id}
Base URLs
| Environment | URL |
|---|---|
| Production | https://shopitup.ca/api/v1 |
| Sandbox — test stores and Stripe test mode; no real orders or payments | https://shopitupbeta.ca/api/v1 |
Endpoints
Catalogue
Search items across stores and read item and store details.
GET Search items across stores GET Item details GET Store details and policies GET Category tree, for filtering searchesCheckout
Price an order and hand the person a link to confirm and pay.
POST Price an order POST Create a checkout for the person to confirm and pay GET Has the person paid? POST Cancel a checkoutAccount
The linked person's orders, tracking and saved sizes (account linking required).
GET The person's price-drop alerts POST Email the person when an item drops to their price DELETE Stop one of the person's price-drop alerts GET The linked person GET The linked person's saved shipping address GET The linked person's orders GET One order, with each store's shipment and trackingGood 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.