API & MCP
Product search, product data, and true landed cost for the US and Canada — from a single REST call or an AI agent. Built for stores that aren't on Shopify.
Authentication
Every request carries your key. Keys are issued per customer and metered monthly.
Authorization: Bearer os_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxTier limits: Studio 2,000 calls/mo ($4.99) · Scale 25,000 calls/mo ($19.99). Call /api/me to see your usage.
Endpoints
| Endpoint | What it returns |
|---|---|
GET /api/search?q=&page=&size= | Product matches with price, image, units sold and rating. |
GET /api/product?id= | Full product: title, images, SKUs, per-SKU price, stock and ship-from. |
GET /api/truecost?id=&qty=&country=US|CA&province=ON | True landed cost: item + live shipping + duty + import tax, with a confidence score and a rates-as-of date. Returns both a landed.US and a landed.CA breakdown. |
GET /api/duty-meta | Version, as-of date and sources for the duty rate table. |
GET /api/order-payload?id=&qty=&country=&province= | The order handoff. The exact variant + SKU, quantity, delivered cost, a ready-to-use order spec and a checklist. Add &format=text for plain text. Orbitsave prepares the spec — it does not place orders or handle payment. |
POST /api/ask | Plain-language analysis of a product's numbers (Pro feature). |
GET /api/me | Your tier and call usage. |
Example — true landed cost into Ontario
curl -H "Authorization: Bearer $ORBITSAVE_KEY" \
"https://orbitsave.com/api/truecost?id=1005007327167276&country=CA&province=ON"{
"ok": true,
"cost": {
"unitPrice": 29.89,
"shipping": 1.99,
"dutyClass": "pet_supplies",
"landed": {
"US": { "duty": 2.69, "tax": 0, "total": 32.58, "range": {"low":31.9,"high":33.2} },
"CA": { "duty": 1.79, "tax": 4.12, "total": 35.80, "currency": "CAD", "confidence": "medium" }
},
"dataAsOf": "2026-10-15"
}
}MCP (for AI agents)
Orbitsave ships a tiny MCP server so Claude, ChatGPT-class tools and local agents can call us directly as tools: search_products, get_product, true_cost.
# in your MCP client config
{
"mcpServers": {
"orbitsave": {
"command": "node",
"args": ["/path/to/orbit-save-mcp.mjs"],
"env": { "ORBITSAVE_KEY": "os_live_..." }
}
}
}The server is a thin wrapper over this REST API — nothing to host, no data stored. Source: mcp/orbit-save-mcp.mjs in the repo.
Connect any store — not just Shopify
Every other dropshipping tool assumes you're on Shopify, WooCommerce or eBay. If you built your own storefront, there was no documented path to product data or landed cost. Now there is.
The loop
GET /api/search?q=— find candidate products for a niche.GET /api/truecost?id=&country=CA&province=ON— price it properly, duty and tax included.GET /api/order-payload?id=&qty=&country=CA&province=ON— the exact variant to buy and a ready order spec.- Store the product in your own catalogue with the real landed cost.
- Re-check periodically — duty rates and shipping change;
dataAsOftells you how fresh the number is.
Works from any language, any stack, any host. If you can make an HTTPS request, you can source.