Catalog API

• Pull — how products get in (primary): connect your product API once in the dashboard and add your product URLs. Whatmore reads each product from your API and stores it — for the initial load, for every new product you add, and on refresh. This is all most integrations need.
• Push — real-time updates (optional): when price or availability changes, push the change via API so tagged products update immediately, without waiting for a refresh.

​

Pull: initial load and refresh

​

How the product id is read from a URL

• Give us a regex to extract it exactly (recommended). For a Nike-style URL https://www.nike.com/t/air-max-90-shoes/CN8490-002, a rule such as ([^/]+)$ (the last path segment) yields CN8490-002. A regex keeps extraction deterministic across all your URL shapes.
• Default behaviour today: with no rule set, Whatmore takes the trailing token of the URL — it splits on - and uses the last segment. That works when the URL ends in the id, but is brittle for other URL patterns, so providing a regex is strongly recommended.

​

Expected product JSON

{
  "id": "CN8490-002",
  "name": "Nike Air Max 90",
  "permalink": "https://www.nike.com/t/air-max-90-shoes/CN8490-002",
  "price": "130.00",
  "regular_price": "150.00",
  "sale_price": "130.00",
  "currency": "USD",
  "description": "The Air Max 90 stays true to its running roots with the iconic Waffle sole.",
  "sku": "CN8490-002",
  "stock_status": "instock",
  "stock_quantity": 42,
  "images": [
    { "src": "https://static.nike.com/air-max-90/CN8490-002.jpg" },
    { "src": "https://static.nike.com/air-max-90/CN8490-002-alt.jpg" }
  ]
}

​

Product identity

• client_product_id — your product id, extracted from the product URL (see above) and normally identical to the id your API returns. It is the key you reuse on every push and in order tracking: whatever value ends up here must be the exact same value you send in order_items[].product_id, or the item can’t be attributed.
• product_link — the product’s URL.
• Whatmore also assigns its own internal numeric product_id for its records.

​

Push: real-time updates

POST /v2/product
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "client_product_id": "CN8490-002",
  "product_link": "https://www.nike.com/t/air-max-90-shoes/CN8490-002",
  "title": "Nike Air Max 90",
  "price": "130.00",
  "compare_price": "150.00",
  "currency": "USD",
  "description": "The Air Max 90 stays true to its running roots.",
  "thumbnail_image": "https://static.nike.com/air-max-90/CN8490-002.jpg",
  "sku": "CN8490-002",
  "stock_status": "instock",
  "stock_quantity": 42,
  "product_status": "active"
}