Ecommerce
Vitals logo

Vitals API

vitals.nl

Vitals — Dutch wholesaler of vitamins and food supplements. Sign in with your trade account to search the range by name, barcode or article number, see your own contract prices alongside list and retail prices, check stock, and build or empty your shopping basket. Nothing is ever checked out — placing the order stays with you.

Actions
8
Category
Ecommerce
Login
Some actions
Output
JSON

Call the Vitals API

Submit a task, then poll the job until it settles. This example runs vt_categories.

curl -X POST https://api.anakin.io/v1/wire/task \
  -H "X-API-Key: $ANAKIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action_id": "vt_categories",
    "params": {}
  }'

8 actions on vitals.nl

Read

  • Get Product Details

    vt_product_detailsreadlogin required2 credits / call

    Look up one Vitals product and get everything the shop holds on it: barcode, article number, Z-Index code, stock, and all three prices — recommended retail, list price and your own contract price. Identify it however you can: barcode, article number, name, link or product ID.

    pid
    number
    ean
    string
    sku
    string
    url
    string
    search_text
    string
  • List Categories

    vt_categoriesread2 credits / call

    List the sections of the Vitals range — vitamins, minerals, amino acids and so on — each with the number of products it holds. A good starting point before listing or searching.

  • List Products

    vt_list_productsreadlogin required2 credits / call

    Browse the Vitals range — one category or the whole catalogue — with your account's own prices when you are signed in. Each product comes back with its name, article number, price, stock status and packaging. Filter by price or stock, and cap how many you get back.

    category
    string
    include_ean
    boolean
    max_products
    integer
    only_stock_items
    boolean
    min_price
    number
    max_price
    number
  • Search Products

    vt_search_productsreadlogin required2 credits / call

    Search the Vitals range by product name, EAN barcode, article number (e.g. V3372) or Z-Index code. A barcode or article number returns a single exact match, which makes this the dependable way to look up order lines. Results carry standard prices; turn on resolve_prices to get your account's own price for each hit.

    search_text
    string · required
    page
    integer
    sort
    string
    resolve_prices
    boolean
  • View Basket

    vt_get_cartreadlogin required2 credits / call

    See what is in your Vitals basket right now: every line with its quantity, your unit price and line total, plus the subtotal, any volume discount, VAT and the total. This is your real basket — the same one you see when you sign in to the website.

Write

Write actions change state on vitals.nl and run as the account you connect.

  • Add Items to Basket

    vt_add_items_to_cartwritelogin required2 credits / call

    Add a whole order to your Vitals basket in one call. Every line is matched to a product, set to the quantity you asked for, checked against the price you expected and confirmed against the basket afterwards — so you get a per-line report of what went in, what could not be matched and where prices differ. Up to 50 lines per call. Updates your real basket; it never places an order.

    items
    array · required
    clear_first
    boolean
    check_prices
    boolean
  • Add to Basket

    vt_add_to_cartwritelogin required2 credits / call

    Add one product to your Vitals basket, or change the quantity of one already in it. Identify the product by barcode, article number, name or product ID. The quantity you give is the final quantity for that line rather than an amount added on top, so running this twice will not double the line. Updates your real basket; it never places an order.

    pid
    number
    ean
    string
    sku
    string
    search_text
    string
    codes
    array
    quantity
    integer
  • Empty Basket

    vt_clear_cartwritelogin required2 credits / call

    Empty your Vitals basket, removing every line and confirming it is empty afterwards. The removed lines come back in full so you can put them back if you need to. This clears your real basket, so it only runs when you set confirm to true — otherwise it just reports what it would remove.

    confirm
    boolean

Vitals API questions

Is there an API for Vitals?
Vitals does not offer a public data API for this, but Anakin Wire provides 8 maintained endpoints for vitals.nl. You call Anakin's REST API with an action ID and parameters and get structured JSON back; Anakin handles the browser, proxies, anti-bot, and parsing.
How do I scrape Vitals data?
POST to https://api.anakin.io/v1/wire/task with your API key, the action ID, and its parameters, then poll GET /v1/wire/jobs/{id} until the job settles. There is nothing to install and no scraper to maintain — when vitals.nl changes its markup, Anakin updates the action.
Do I need a Vitals account?
Some Vitals actions read data that is only visible when signed in, so those need a credential you connect once. Actions marked "read" without a login requirement run anonymously.
What does the Vitals API cost?
Usage-based credits, charged per call and refunded automatically when a job fails. New accounts start with 300 free credits and no card. See anakin.io/pricing for the current rates.

More Ecommerce APIs

All Ecommerce sites