{"openapi":"3.1.0","info":{"title":"Botsket","version":"0.1.0","description":"Botsket searches products from independent US online stores (WooCommerce) and\nsays whether an AI agent can actually check out at each store. Prices are in USD.\n\nUse search_products to find offers. Before recommending or buying one, call get_offer: it\nre-checks price and stock with the store and returns price_checked_at. The search index is\nrefreshed weekly, so search prices can be a few days old.\n\nEach store has agent_checkout:\n- clean: our test agent got from the home page to the card form without obstacles.\n- friction: it met a popup, cookie banner, CAPTCHA or an unconfirmed step; may or may not work.\n- cannot finish: our test agent could not reach the card form. Prefer other stores.\n- not tested: unknown.\n\nProducts with variants (sizes, colours) give the lowest price as price and the highest as\nprice_max. url is the store's own product page; Botsket sells nothing.\n\nResults that match every query word come first. When there are too few, offers matching some\nof the words follow, with matched_all_words false; treat those as loose matches."},"servers":[{"url":"https://botsket.com"}],"paths":{"/api/search":{"get":{"operationId":"searchProducts","summary":"Search products across independent US stores","parameters":[{"name":"q","in":"query","required":true,"description":"What to look for","schema":{"type":"string"}},{"name":"max_price","in":"query","required":false,"description":"Highest price in USD","schema":{"type":"number"}},{"name":"min_price","in":"query","required":false,"description":"Lowest price in USD","schema":{"type":"number"}},{"name":"in_stock_only","in":"query","required":false,"description":"Default true","schema":{"type":"boolean"}},{"name":"agent_checkout","in":"query","required":false,"description":"any | not_blocked | clean","schema":{"type":"string","enum":["any","not_blocked","clean"]}},{"name":"sort","in":"query","required":false,"description":"relevance | price","schema":{"type":"string","enum":["relevance","price"]}},{"name":"store","in":"query","required":false,"description":"Only this store domain","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1 to 50, default 10","schema":{"type":"integer"}}],"responses":{"200":{"description":"Offers, at most three per store"}}}},"/api/offers/{domain}/{product_id}":{"get":{"operationId":"getOffer","summary":"Re-check one offer's price and stock with the store","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"The offer"},"404":{"description":"Not in the index or no longer sold"}}}},"/api/stores/{domain}":{"get":{"operationId":"getStore","summary":"A store and whether an AI agent can check out there","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The store"},"404":{"description":"Not in the index"}}}}}}