Quickstart API reference MCP API keys Authentication
v1.2.8.0 · OpenAPI 3.1 · Sandbox + Live

Build on the
Viewider Product API.

One REST API for products, inventory, marketplace listings, shipments and B2B orders across Viewider. Authenticate with a Bearer machine-token and go.

97 endpoints across 11 resources Bearer machine-token · self-rotating (FIX-314) JSON status envelope · always check status
curlNodePython
Copy
curl https://api.viewider.com/externalAPI/rotateMachineToken \
  -d client_id=mtok_2042e4… \
  -d client_secret=••••••••
→ 200 SUCCESS34 MS
{
  "status": "success",
  "response": {
    "access_token": "eyJ…",
    "token_type": "Bearer",
    "expires_in": 86400
  }
}

60-second quickstart

Auth reference →
1

Get your credentials

Each integration gets a client_id + client_secret — a dedicated, scoped service credential. Keys are self-serve — create one in the API keys portal.

2

Mint a Bearer token

Exchange client_id + client_secret for a short-lived Bearer machine-token. Re-mint on a schedule or on a 401.

curl https://api.viewider.com/externalAPI/rotateMachineToken \
  -d client_id=mtok_2042e4… -d client_secret=••••••••
# -> { "status":"success", "response":{ "access_token":"eyJ…", "token_type":"Bearer", "expires_in":86400 } }
3

Call an endpoint

Send the token as a Bearer header to any of the 97 endpoints. Every response is a JSON status envelope — always check the status field.

curl https://api.viewider.com/externalAPI/product/getProductGroupID \
  -H "Authorization: Bearer $TOKEN" -d UserID=12345

Use Viewider from your AI agent

Invite-only pilot

Viewider ships a Model Context Protocol (MCP) server that exposes 84 tools over this same API (73 read-only + 11 write) — products, listings, orders, sales records, transactions, inventory and shipping. Write tools require a key carrying the product:write capability; read-only keys get 403 on them. Authenticate with an API key from the portal: the server mints 24-hour Bearer tokens and re-mints them automatically. The npm package is rolling out to pilot accounts.

Explore the API

Full reference →