在Camden工具商店选购 你的AI助手

Search and browse products, full product details, live stock, side-by-side comparisons, documents, categories and brands.

• search_productsSearch products只读

  Full-text search of the Camden Tools catalogue (tools and hardware, electrical, cleaning, household, garden, safety and more). Returns compact products with prices ex/inc VAT, stock and a link. Out-of-stock products are left out unless include_out_of_stock is true. Use page/per_page to paginate and brand/min_price/max_price to narrow down.

  参数	类型	描述
  query* (必需)	string	What the shopper is looking for, e.g. 'cordless combi drill 18v'.
  express	boolean	Only products eligible for Website Express same-day dispatch (UK).
  include_out_of_stock	boolean	Also return out-of-stock products, which search leaves out by default. Use it when the shopper wants a specific model that may be sold out.
  page	integer	Page number, starting at 1.
  per_page	integer	Results per page: 15, 30, 50 or 100 (default 15).
  sort	string	Sort order: price_low, price_high, name_asc, name_desc or newest. Omit for the default (most popular) order.
  brand	string	Brand slug to filter by.
  min_price	number	Minimum price in the locale currency.
  max_price	number	Maximum price in the locale currency.
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

• list_productsList products只读

  Browse a product collection: most popular, newest, on sale, Website Express eligible, or a category by slug (see list_categories). Supports paging, sorting and brand/price filters.

  参数	类型	描述
  collection* (必需)	popular | new | on-sale | express | category	Which collection to list.
  category_slug	string	Required when collection is 'category': a category (leaf) slug from list_categories.
  min_discount	number	Minimum discount percentage (on-sale listings).
  page	integer	Page number, starting at 1.
  per_page	integer	Results per page: 15, 30, 50 or 100 (default 15).
  sort	string	Sort order: price_low, price_high, name_asc, name_desc or newest. Omit for the default (most popular) order.
  brand	string	Brand slug to filter by.
  min_price	number	Minimum price in the locale currency.
  max_price	number	Maximum price in the locale currency.
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

• get_productGet product只读

  Full details for one product by slug, SKU or id: description, specifications, prices ex/inc VAT with bulk breaks, stock, variants, safety/spec documents and the canonical page URL. Provide exactly one of slug, sku or id.

  参数	类型	描述
  slug	string	Product slug from a product URL (…/product/<slug>).
  sku	string	Product SKU.
  id	integer	Numeric product id.
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

• get_productsGet several products只读

  Look up up to 50 products at once by SKU or by numeric id. Returns compact products (name, price ex/inc VAT, stock, link).

  参数	类型	描述
  skus	array of string
  ids	array of integer
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

• get_stock_levelGet stock level只读

  Live availability check for a SKU: whether it can be bought now and how many units can be ordered. Fresher than the stock_level on product results, which can be hours old.

  参数	类型	描述
  sku* (必需)	string	Product SKU exactly as shown on the site.

• compare_productsCompare products只读

  Side-by-side comparison of 2 to 5 products by SKU: price ex/inc VAT, stock, brand, shipping weight and the specification bullet points, so an agent can recommend between options.

  参数	类型	描述
  skus* (必需)	array of string
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

• get_related_productsGet related products只读

  Variants, similar products, recommendations and 'you may also like' items for a product (by slug or SKU). Useful for alternatives when something is out of stock.

  参数	类型	描述
  slug	string	Product slug from a product URL (…/product/<slug>).
  sku	string	Product SKU.
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

• get_product_documentsGet product documents只读

  Safety data sheets, specification sheets and COSHH hazard codes for a product (by slug or SKU). Returns document URLs.

  参数	类型	描述
  slug	string	Product slug from a product URL (…/product/<slug>).
  sku	string	Product SKU.
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

• list_categoriesList categories只读

  The category tree: departments, the groups inside them, and the categories (leaves) that hold products. With no department, lists every department and its groups; with a department or group slug, lists what is inside it. Use popular_only for the popular categories shown on the site. Browse a category's products with get_category or list_products.

  参数	类型	描述
  department	string	A department or group slug from an earlier list_categories call, to list what is inside it.
  popular_only	boolean	Only the popular categories (default false).
  limit	integer	Maximum entries to return (default 200).
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

• get_categoryGet category只读

  A category's details and its products (paged) by slug. For a department or group slug, returns what is inside it instead, since only categories hold products.

  参数	类型	描述
  slug* (必需)	string	Category slug from list_categories.
  page	integer	Page number, starting at 1.
  per_page	integer	Results per page: 15, 30, 50 or 100 (default 15).
  sort	string	Sort order: price_low, price_high, name_asc, name_desc or newest. Omit for the default (most popular) order.
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

• list_brandsList brands只读

  Brands sold by Camden Tools (DeWalt, Makita, Milwaukee, Bosch, Stanley …). Without a query returns the popular brands; with a query searches brand names.

  参数	类型	描述
  query	string	Brand name search text.
  page	integer	Page number, starting at 1.
  per_page	integer	Results per page: 15, 30, 50 or 100 (default 15).
  sort	string	Sort order: price_low, price_high, name_asc, name_desc or newest. Omit for the default (most popular) order.

• get_brand_productsGet brand products只读

  A brand's details, its active promotions and its products (paged) by brand slug.

  参数	类型	描述
  slug* (必需)	string	Brand slug from list_brands.
  page	integer	Page number, starting at 1.
  per_page	integer	Results per page: 15, 30, 50 or 100 (default 15).
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

Current promotions, per-product deals, curated bundles and basket-level promotion checks.

• list_offersList offers只读

  Current storefront promotions (percentage/fixed discounts and free gifts), optionally grouped by brand or category. Also points at the /offers page.

  参数	类型	描述
  group_by	all | brand | category	Grouping (default all).
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

• get_product_promotionsGet product promotions只读

  Active promotions that apply to one SKU (discounts, free gifts, end dates).

  参数	类型	描述
  sku* (必需)	string	Product SKU exactly as shown on the site.
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

• list_bundlesList bundles只读

  Curated product bundles (kits) with their items and prices.

  参数	类型	描述
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

• get_cart_promotionsGet basket promotions只读

  Evaluate a prospective basket for a destination country: whether it can be fulfilled, which promotions apply (including free-delivery style offers and free gifts) and the adjusted basket value. Same check the checkout runs.

  参数	类型	描述
  country_code* (必需)	string	Destination country (ISO alpha-2).
  items* (必需)	array of object { id, quantity }	Basket lines as product ids with quantities.
  has_tax_id	boolean	Whether the buyer has a VAT/tax id (business purchase).
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

Website Express same-day dispatch, shipping availability by country, country pricing, delivery estimates and UK postcode lookup.

• get_express_delivery_statusGet Website Express status只读

  Whether Website Express (free same-working-day dispatch for eligible UK orders) is available right now, the order-by cutoff and the promised dispatch date.

  参数	类型	描述
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

• check_express_eligibilityCheck Website Express eligibility只读

  Whole-basket Website Express verdict for a set of product ids and quantities: every line must be eligible (no split shipments).

  参数	类型	描述
  items* (必需)	array of object { id, quantity }	Basket lines as product ids with quantities.
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

• check_shipping_availabilityCheck shipping availability只读

  Whether Camden Tools ships to a country, with any restriction message.

  参数	类型	描述
  country_code* (必需)	string	ISO 3166-1 alpha-2 country code, e.g. GB, IE, DE, US.
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

• get_prices_for_countryGet prices for a country只读

  Country-specific pricing for a set of products (the checkout applies the destination country's currency and pricing). Returns unit, sale and final prices plus the subtotal.

  参数	类型	描述
  shipping_country* (必需)	string	ISO 3166-1 alpha-2 country code, e.g. GB, IE, DE, US.
  items* (必需)	array of object { id, quantity }	Basket lines as product ids with quantities.
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

• estimate_deliveryEstimate delivery只读

  Delivery services, charges and transit times for a basket to a destination (country plus postcode/ZIP and city). This is an estimate using placeholder contact details; exact rates are confirmed at checkout.

  参数	类型	描述
  country_code* (必需)	string	ISO 3166-1 alpha-2 country code, e.g. GB, IE, DE, US.
  postcode	string	Destination postcode / ZIP.
  city	string	Destination city.
  items* (必需)	array of object { id, quantity }	Basket lines as product ids with quantities.
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

• lookup_uk_postcodeLook up a UK postcode只读

  Addresses for a full UK postcode such as NW2 7JW (rate limited upstream). A partial postcode (only the outward part, e.g. NW2) is refused.

  参数	类型	描述
  postcode* (必需)	string	UK postcode, e.g. NW2 7JW.

Prepare a basket the shopper opens on the site, reviews and pays for at checkout.

• create_basket_linkCreate a basket link只读

  Turn product ids and quantities into one link that fills the shopper's basket on camdentools.com. Opening the link makes sure the basket holds at least those quantities (opening it twice does not double them); the shopper reviews the basket and pays at checkout themselves. The result says which lines are out of stock: those cannot be bought, so offer an alternative before sharing the link. Use it to finish a shopping conversation. Ids come from search_products, list_products or get_product.

  参数	类型	描述
  items* (必需)	array of object { id, quantity }	Basket lines as product ids with quantities.
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

Track any order with its order number and delivery postcode.

• track_guest_orderTrack an order只读

  Order status, tracking number/URL, shipping method and line items for any order, given the order number and the delivery postcode (no sign-in needed).

  参数	类型	描述
  order_number* (必需)	string	Order number from the confirmation email.
  postcode* (必需)	string	Delivery postcode / ZIP on the order.

The signed-in shopper's profile and order history. Only from the shopper's own browser on camdentools.com, after they allow AI agent access.

• get_my_profileGet my profile浏览器会话只读

  The signed-in shopper's name, email and saved addresses. Needs the shopper's browser session with AI agent access, or an OAuth token with the profile:read scope.

  没有参数。

• list_my_ordersList my orders浏览器会话只读

  The signed-in shopper's order history (most recent first). Needs the shopper's browser session with AI agent access, or an OAuth token with the orders:read scope.

  参数	类型	描述
  page	integer	Page number, starting at 1.

• get_my_orderGet my order浏览器会话只读

  One of the signed-in shopper's orders by order number, with status, tracking and line items. Needs the shopper's browser session with AI agent access, or an OAuth token with the orders:read scope.

  参数	类型	描述
  order_number* (必需)	string

Store facts, policies, the London collection point and the blog.

• get_site_infoGet store information只读

  Who Camden Tools is, how to contact them, VAT display rules, key page links, current announcements and a summary of each policy (delivery, returns, payment, FAQs). Call get_policy for the full text of a policy.

  参数	类型	描述
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

• get_policyGet policy text只读

  Full text (markdown) of a store policy: delivery, returns, payment-options, faqs or contact.

  参数	类型	描述
  policy* (必需)	delivery | returns | payment-options | faqs | contact
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.

• get_collection_point_infoGet collection point info只读

  The London Click & Collect warehouse: address, opening hours, whether it is open right now (Europe/London, bank holidays respected) and when it next opens.

  没有参数。

• search_blog_postsSearch blog posts只读

  Guides and articles from the Camden Tools blog (how-tos, buying guides, brand news).

  参数	类型	描述
  query	string	Search text; omit for the latest posts.
  page	integer	Page number, starting at 1.

• get_blog_postGet blog post只读

  A blog post's full text (plain text) by slug.

  参数	类型	描述
  slug* (必需)	string
  locale	string	Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.