Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
5 shown · authentication unknown
Can a shopper make this retailer an offer?
can_make_offer
Returns whether a shopper can make this retailer an offer instead of paying the listed price. answer is yes (the retailer accepts offers through Bidit now; offers_url is where) or not_yet (the retailer does not; register_interest_url and consent_text describe how a shopper can register the price they would pay). There is no third state.
Find products at retailers that take offers or price match
find_products
Searches the products the Registry has pulled from its retailers' own catalogues (Shopify stores, up to 500 products each) and returns each hit with its price, its page at the store, when it was last seen, and the store's verified facts: whether it accepts offers (true only when the store is in the engine's live list) and whether it price matches (yes or no only after a person verified the policy; unknown otherwise). Filter by country, a ceiling on price, only stores that take offers, or only stores with a verified price-match policy. Prices and availability are as of last_seen_at; confirm on the product page before quoting. Not every retailer's products are listed, so an empty result is not a no.
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "What the shopper wants, in a few words, e.g. 'linen shirt', 'Dyson V15', 'gold hoop earrings'"
},
"country": {
"type": "string",
"description": "ISO 3166 two-letter country code, e.g. AU. Optional."
},
"price_max": {
"type": "number",
"description": "Only products whose lowest price is at or under this, in the store's currency. Optional."
},
"accepts_offers": {
"type": "boolean",
"description": "true: only stores where a shopper can make an offer. Optional."
},
"price_match": {
"type": "boolean",
"description": "true: only stores with a verified price-match policy. Optional."
},
"limit": {
"type": "integer",
"description": "How many products to return, 1 to 100. Default 20."
}
},
"required": [
"query"
],
"additionalProperties": false
}
A retailer's verified price policy
price_policy
Returns everything the Registry has verified about how a retailer handles price: whether it takes offers through Bidit, whether it price matches and on what terms, how it runs promotions, and its clearance page. Fields are null where nothing has been verified.
Returns the retailers whose price-match policy a person has verified, optionally filtered by category and country, each with its terms and policy page. A retailer absent from the list is unverified, not a no.
Returns whether a retailer publishes a policy of matching a competitor's lower price, with the verified terms, exclusions, how to claim, a sentence quoted from the policy and the policy page. answer is yes (a person has verified the published policy), no (a person looked and found none) or unknown (not verified). Whether a particular competitor price qualifies depends on the terms returned.
Schema valid · SHA-256 d0dd8a746298…
View input schema
{
"type": "object",
"properties": {
"retailer": {
"type": "string",
"description": "Retailer name, domain or Registry slug, e.g. 'JB Hi-Fi', 'jbhifi.com.au' or 'jbhifi'"
},
"competitor_price": {
"type": "number",
"description": "The lower price the shopper has found, in the retailer's currency. Optional; echoed back with the terms."
},
"product": {
"type": "string",
"description": "What the shopper wants to buy. Optional."
}
},
"required": [
"retailer"
],
"additionalProperties": false
}