search_products
Search products Read Search the AVDEB catalog (stickers, decals, name badges, NFC keychains, 3D printed goods, gifts) by keywords. Returns matching products with price range, stock and product page URL.
Input
| Name | Type | Details |
| query * | string | What the shopper is looking for, e.g. 'cat laptop sticker'. (
2–200 chars)
|
| limit | integer | (
1–20, default 8)
|
* required
Returns
- query
- The search text that was used
- results[]
- handle, title, url, type, price { min, max, currency }, in_stock, personalized, ordering_mode (standard | website_designer), image
- tip
- Only when nothing matched
Example request: “Find a cute cat sticker for my laptop under $5.”
get_product
Get product details Read Full details for one product: description, options and variants with prices and stock, personalization fields, images, categories, FAQs and return eligibility.
Input
| Name | Type | Details |
| handle * | string | Product handle, or a product URL like https://avdeb.com/store/{handle}/. (
1–200 chars)
|
* required
Returns
- handle, title, url, type, price, in_stock, personalized, ordering_mode, image
- Same summary as search results
- description
- Up to 2,000 characters
- options[]
- { title, values[] }
- variants[]
- { variant_id, title, price, compare_at_price, options, available } — up to 50
- personalization_fields[]
- { key, label, required, max_length, multiline }
- images[]
- Up to 6 { url, alt }
- categories[]
- { name, slug }
- faqs[]
- Up to 8 { question, answer }
- returns
- Return eligibility for this product
- seller
- AVDEB, or the designer credit for creator-marketplace products
- ordering
- { mode, note } — website_designer products are ordered on the product page
Example request: “What sizes and finishes does the angel cat sticker come in?”
list_categories
List categories Read All product categories in the AVDEB store with their slugs, for use with browse_category.
Input
No arguments.
Returns
- categories[]
- { name, slug, parent_slug, description }
Example request: “What kinds of products does AVDEB sell?”
browse_category
Browse a category Read Products in one category (slug from list_categories), with price range, stock and product page URL.
Input
| Name | Type | Details |
| slug * | string | (
1–120 chars)
|
| page | integer | (
1–50, default 1)
|
| page_size | integer | (
1–24, default 12)
|
* required
Returns
- category, page, page_size, total
- Paging information
- products[]
- Product summaries (as in search results)
Example request: “Show me AVDEB's car decals.”
get_store_info
Store policies Read Shipping rates and free-shipping threshold, processing and delivery times, current offers, returns, payment and how ordering works at AVDEB.
Input
No arguments.
Returns
- ships_to, currency
- Shipping countries and price currency
- shipping_options[]
- { id, name, price }
- free_shipping
- { min_subtotal, applies_to, members_only } or null
- processing, transit, estimated_delivery_if_ordered_now
- Handling cut-off, carrier transit time and dates
- offers[]
- Automatic discounts currently running
- returns, payment, how_to_order, policies, contact
- Store policies and links
Example request: “How fast does AVDEB ship to California, and when is shipping free?”
quote_order
Quote an order Read Price a prospective order: validates products, variants and personalization, applies the automatic multi-buy offer or a coupon, and returns shipping options and the total before sales tax (tax is calculated at checkout). Read-only: it doesn't create an order, reserve stock or charge anything.
Input
| Name | Type | Details |
| items * | array of objects | (
1–20 items)
|
| items[].handle * | string | Product handle (from search_products, browse_category or get_product). (
1–200 chars)
|
| items[].variant_id | string | Variant id from get_product. Use this or options. (
≤ 40 chars)
|
| items[].options | object (string → string) | Option selections from get_product, e.g. {"Size": "3\" x 3\""}. Use this or variant_id. |
| items[].quantity | integer | (
1–100, default 1)
|
| items[].personalization | object (string → string) | Values for the product's personalization fields, keyed by field key (from get_product). |
| shipping_address | object | |
| shipping_address.country | string | ISO 3166-1 alpha-2 code. Only US is shipped to. (
exactly 2 chars, default "US")
|
| shipping_option | string | Shipping option id or name; defaults to the cheapest. (
≤ 100 chars)
|
| coupon_code | string | (
≤ 50 chars)
|
* required
Returns
- items[]
- { handle, title, variant, selected_options, choose_on_product_page?, unit_price, quantity, line_total, personalization, product_url }
- subtotal
- Items before discounts
- discounts[]
- { type: multi_buy | coupon, description, amount }
- coupon
- { code, applied, reason? } — only when a coupon_code was sent
- shipping
- { selected, options[] { id, name, price, free } }
- total_before_tax
- Discounted items + shipping. Sales tax is added at checkout
- estimated_delivery
- { ships_by, earliest, latest }
- notes[]
- What the quote does and doesn't include
- quoted_at
- ISO 8601 timestamp
Example request: “How much are four 3-inch glossy angel cat stickers, shipped?”
