Deal.ai

Asks Deal.ai's shopping agent, for the signed-in Deal.ai account: it researches products, compares US stores' prices and recommends the best picks, as on deal.ai. Give search_id from an earlier answer to ask a follow-up in the same conversation. Answers take one to three minutes: this waits about 20 seconds and returns the answer if it's ready, else a search_id for get_deal_ai_answer. An answer has the agent's words and each pick's best store price with when it was seen, rating, deal.ai page and store link. The picks are watched for price drops for the account, as searches on deal.ai are.

ask_deal_ai

Starts a deal check on a product link from any store, or a product's name, and optionally the price the shopper was offered. It finds this exact item (same model, size and generation) at every big US store right now, compares their prices and checks the store's "was" price. Returns a check_id and the check's deal.ai page at once; the check takes 20 to 70 seconds, so call get_deal_check for the result.

check_deal

Sets two to four products (product_ids from search_products, or deal.ai links) side by side: each one's rating and best current price from a store with when it was seen, their specifications aligned by name where they share them, each product's deal.ai page, and deal.ai's comparison page for a pair where there is one.

compare_products

The answer to a question asked with ask_deal_ai: still running (with what the agent is doing), didn't finish, a question the agent asks back, or the answer: the agent's words and each pick's best store price with when it was seen, rating, deal.ai page and store link.

get_deal_ai_answer

The result of a deal check started with check_deal: still running, or the verdict in one sentence (cheaper elsewhere, the lowest price, the only store), each store's price for the exact item, the "was" price checked, and the check's deal.ai page.

get_deal_check

For one product (a product_id from search_products, or its deal.ai link): its name, brand, model and category, its description, the fact sheet read from a store's page (highlights, what's in the box, returns, what buyers praise and complain about), its main specifications, rating, a few photos, variants and sizes, the best current price from a store with when it was seen, and the product's deal.ai page.

get_product_details

For one product (a product_id from search_products, or its deal.ai link): every store's current price Deal.ai has, cheapest first, with shipping, condition, stock and when each was seen; the lowest and highest prices tracked; recent daily lows; and the product's deal.ai page.

get_product_prices

Deal.ai's live deals, checked against other stores and ranked as deal.ai lists them: this hour's deals, or a store's, or those matching what was asked for, optionally by category, discount and price. Each deal's title, price, the earlier or usual price it's measured against and the discount, the store, when it was checked, its deal.ai page and a link to buy it.

get_deals

The products on the signed-in account's Deal.ai wish list, whose price drops it is e-mailed about: each one's best store price now and where, with when it was seen, its reference price (the price when it was saved or last e-mailed), and its deal.ai page; and whether the account's price alerts are on.

list_watched

Searches Deal.ai's product price pages, live deals, buying guides and side-by-side comparisons. Returns each page's title, kind, latest price (with the day it was seen), saving or rating where it has one, a product_id for products, and its deal.ai link.

search_products