search_offers
Search akay.ie offers
Search open akay.ie trade offers by keyword, EAN, size ("70cl", "6x70cl"), ABV or duty status, with optional website filters. Returns listed sell prices per case and per unit in each offer's own currency (EUR, USD or GBP), pack, duty status, Incoterm, location and stock. Paged: up to 25 per page, 10 pages per query.
輸入參數pagebrandqueryorigincategorycurrencyincotermlocationpage_sizeduty_statusstock_status
get_offer
Get one akay.ie offer
Full public details of one open offer by its akay.ie offer_id (or akay.ie offer URL), with the akay.ie link and how to order.
輸入參數offer_id必填
get_price
Price one product
Price one product (offer_id, EAN or name) for a quantity in cases. Returns the listed price per case and per unit in the offer's currency, the line total worked out in code, and MOQ and stock checks. If several offers fit, returns candidates instead of picking one. Optional target price comparison. Once the buyer is happy with a line, offer request_quote.
輸入參數abveanpackcasesunitsproductoffer_idvolume_mlduty_statustarget_basistarget_pricetarget_currency另有 2 個
list_categories
List categories
Categories with offer counts and top brands, plus the values available for the duty status, Incoterm, stock and location filters.
無需輸入參數。
price_my_list
Price my buying list
Price a buying list (up to 100 lines / 20 KB): product names or EANs, quantities in cases and optional target prices. Paste it as text (one product per line, or CSV/TSV with a header row) or give structured lines. Each line comes back with a match status (matched, ambiguous, not_listed, moq_not_met, insufficient_stock, price_unavailable), the listed price, pack, stock, duty status, Incoterm and line total. Lines keep their own currency (EUR, USD or GBP); totals are subtotals per currency, never converted or summed across currencies.
輸入參數textlines
request_quote
Prepare a quote request
Turn confirmed lines (offer_id + cases, or units for offers priced per unit) into a quote request summary and a CSV the buyer uploads at quote.akay.ie/#excel, plus WhatsApp and email options. Totals are per currency, never summed across currencies. Use it whenever the buyer says they want a quote, an order or to buy, and offer it after showing prices. Sends nothing, reserves nothing and needs no contact details.
輸入參數lines必填
search
Search akay.ie (ids and links)
Search the akay.ie trade catalogue. Returns offer ids, titles and akay.ie URLs. Use fetch with an id for full details.
輸入參數query必填
fetch
Fetch one akay.ie offer by id
Fetch the full public details of one akay.ie offer by the id returned from search.
輸入參數id必填