{"slug":"hubvibe-io-com-work-commerce-availability-6cc3fd","title":"Live buy/book check on any product or booking page","host":"hubvibe-io.com","method":"POST","resource":"https://hubvibe-io.com/work/commerce/availability","category":"commerce","description":"Live buy/book check on any product or booking page: can it be purchased right now, at what price, in which options (sizes, colours, dates, rooms), which option matches the variant you name, quantity and ship-to eligibility where the page states them, with evidence and a checked_at stamp. Read at cal","price_listed":0.5,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"url":"https://www.allbirds.com/products/mens-wool-runners","variant":"size 10"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"properties":{"language":{"description":"Optional BCP-47 language tag (en, ja, pt-BR, zh-Hant): every prose field of the answer is written in this language. Default: the language of the material or question.","maxLength":35,"pattern":"^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$","type":"string"},"quantity":{"description":"Optional: how many you need.","maximum":100000,"minimum":1,"type":"integer"},"ship_to":{"description":"Optional: ISO 3166-1 alpha-2 country the order ships to.","maxLength":2,"minLength":2,"type":"string"},"url":{"description":"The product, listing or booking page.","type":"string"},"variant":{"description":"Optional: the option you want, in words (size 9 natural black; double room 12 Oct; economy).","maxLength":200,"type":"string"}},"required":["url"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"$schema":"https://json-schema.org/draft/2020-12/schema","description":"The 200 body of every paid /work call. `result` is the worker's own output (its schema is per route); everything else is the same on every /work route. A receipt for the job is at `receipt_url`.","properties":{"billing_warning":{"description":"Present only when the charge was recorded with a caveat.","examples":["settlement pending"],"type":"string"},"price_usd":{"description":"What this call cost, in USD.","examples":[0.02],"type":"number"},"provenance":{"description":"How the result was produced: which providers ran and how long each took.","properties":{"attempts":{"description":"Provider attempts made, including retries and failovers.","examples":[1],"type":"integer"},"elapsed_ms":{"description":"Wall-clock milliseconds for the whole job.","examples":[340],"type":"integer"},"providers_used":{"description":"Providers that served the job.","examples":[["coinbase-advanced-trade-public"]],"items":{"description":"Provider name.","examples":["coinbase-advanced-trade-public"],"type":"string"},"type":"array"},"steps":{"description":"Every step the job ran, in order.","items":{"description":"One step of the job.","properties":{"ms":{"description":"Milliseconds the step took.","examples":[312],"type":"integer"},"ok":{"description":"Whether the step succeeded.","examples":[true],"type":"boolean"},"provider":{"description":"Provider that served the step.","examples":["coinbase-advanced-trade-public"],"type":"string"},"reason":{"description":"Failure reason, on a failed step.","examples":["provider_timeout"],"type":"string"},"step":{"description":"Step name inside the worker.","examples":["quote"],"type":"string"}},"required":["step","ok","ms"],"type":"object"},"type":"array"}},"required":["steps","providers_used","attempts","elapsed_ms"],"type":"object"},"receipt_id":{"description":"Receipt id for this job.","examples":["rcpt_9f1c2b3a4d5e6f70"],"type":"string"},"receipt_url":{"description":"Where to fetch the machine-readable receipt (free, no payment).","examples":["/work/receipts/rcpt_9f1c2b3a4d5e6f70"],"type":"string"},"result":{"properties":{"availability":{"description":"Availability of the option asked for (or of the product when no variant was named).","enum":["in_stock","out_of_stock","preorder","backorder","limited","discontinued","unknown"],"examples":["in_stock"],"type":"string"},"available":{"description":"Purchasable or bookable right now under the conditions asked; null when the page does not say.","examples":[true],"type":["boolean","null"]},"checked_at":{"description":"When the page was read (UTC). The answer was true at this moment; nothing here is cached.","examples":["2026-09-26T18:00:00Z"],"format":"date-time","type":"string"},"confidence":{"description":"high: exact structured data for the option asked; medium: page-level tags only; low: model reading or nothing found.","enum":["high","medium","low"],"examples":["high"],"type":"string"},"currency":{"description":"ISO 4217 currency of `price`; null when not stated.","examples":["USD"],"type":["string","null"]},"eligibility_notes":{"description":"Restrictions and caveats, in words.","examples":[[]],"items":{"description":"A restriction or caveat the page states, or why a condition could not be checked.","examples":["Ships to US, CA and GB only."],"type":"string"},"type":"array"},"evidence":{"description":"The evidence behind the answer, best first.","items":{"description":"What the answer rests on: a structured-data field or an exact quote from the page.","examples":["JSON-LD Offer availability https://schema.org/InStock price 110 USD"],"type":"string"},"type":"array"},"final_url":{"description":"The URL after redirects.","examples":["https://example.com/products/wool-runner"],"type":["string","null"]},"http_status":{"description":"HTTP status of the page fetch.","examples":[200],"type":["integer","null"]},"javascript_rendered":{"description":"Whether a real browser had to render the page to answer.","examples":[false],"type":"boolean"},"language":{"description":"BCP-47 tag the prose fields were written in; null for the page's own language.","examples":["en"],"type":["string","null"]},"matched_option":{"description":"The option matching `variant`; null when no variant was asked or none matched.","properties":{"availability":{"description":"Availability of this option.","enum":["in_stock","out_of_stock","preorder","backorder","limited","discontinued","unknown"],"examples":["in_stock"],"type":"string"},"available":{"description":"Purchasable now; null when the page does not say.","examples":[true],"type":["boolean","null"]},"currency":{"description":"ISO 4217 code; null when not stated.","examples":["USD"],"type":["string","null"]},"name":{"description":"The option as the page names it.","examples":["Natural Black / 10"],"type":"string"},"price":{"description":"Price of this option; null when not stated.","examples":[110],"type":["number","null"]},"sku":{"description":"SKU when the page states one.","examples":["WR3MNCW100"],"type":["string","null"]},"url":{"description":"Option-specific URL when the page gives one.","examples":["https://example.com/products/wool-runner?variant=10"],"type":["string","null"]}},"required":["name","available","availability","price","currency"],"type":["object","null"]},"model":{"description":"The model used, only when the model layer ran.","examples":["gemini-2.5-flash"],"type":["string","null"]},"options":{"description":"Every purchasable variation the page lists (sizes, colours, dates, rooms, fares).","items":{"description":"One purchasable variation.","properties":{"availability":{"description":"Availability of this option.","enum":["in_stock","out_of_stock","preorder","backorder","limited","discontinued","unknown"],"examples":["in_stock"],"type":"string"},"available":{"description":"Purchasable now; null when the page does not say.","examples":[true],"type":["boolean","null"]},"currency":{"description":"ISO 4217 code; null when not stated.","examples":["USD"],"type":["string","null"]},"name":{"description":"The option as the page names it.","examples":["Natural Black / 10"],"type":"string"},"price":{"description":"Price of this option; null when not stated.","examples":[110],"type":["number","null"]},"sku":{"description":"SKU when the page states one.","examples":["WR3MNCW100"],"type":["string","null"]},"url":{"description":"Option-specific URL when the page gives one.","examples":["https://example.com/products/wool-runner?variant=10"],"type":["string","null"]}},"required":["name","available","availability","price","currency"],"type":"object"},"type":"array"},"options_count":{"description":"How many options the page lists.","examples":[7],"type":"integer"},"price":{"description":"Price of the matched option, else the product's; null when not stated.","examples":[110],"type":["number","null"]},"quantity":{"description":"The quantity asked for.","examples":[2],"type":["integer","null"]},"quantity_ok":{"description":"Whether that quantity can be ordered; null when the page does not say.","examples":[true],"type":["boolean","null"]},"ship_to":{"description":"The country asked for.","examples":["US"],"type":["string","null"]},"ship_to_ok":{"description":"Whether the page says it delivers there; null when it does not say.","examples":[true],"type":["boolean","null"]},"shipping":{"description":"What the page states about shipping or delivery; null unless stated.","examples":["Free shipping on orders over $75"],"type":["string","null"]},"source":{"description":"Which layer answered: the page's JSON-LD, the Shopify product JSON, Open Graph tags, the model over the rendered page, or nothing usable.","enum":["jsonld","shopify","opengraph","llm","none"],"examples":["jsonld"],"type":"string"},"title":{"description":"Product or listing name from the page.","examples":["Wool Runner"],"type":["string","null"]},"url":{"description":"The page checked.","examples":["https://example.com/products/wool-runner"],"type":"string"},"variant":{"description":"The variant asked for, as given.","examples":["size 10"],"type":["string","null"]}},"required":["url","available","availability","price","currency","options","options_count","matched_option","quantity_ok","ship_to_ok","eligibility_notes","evidence","source","javascript_rendered","confidence","checked_at"],"type":"object"},"status":{"const":"ok","description":"Present only on a delivered result.","type":"string"},"worker":{"description":"Catalog name of the worker that ran.","examples":["market.quote"],"type":"string"}},"required":["status","worker","price_usd","result","provenance","receipt_id","receipt_url"],"title":"commerce.availability response","type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"Live buy/book check on any product or booking page: can it be purchased right now, at what price, in which options (sizes, colours, dates, rooms), which option matches the variant you name, quantity and ship-to eligibility where the page states them, with evidence and a checked_at stamp. Read at call time: schema.org JSON-LD, Open Graph and Shopify product JSON first; a browser render and Gemini only when the page gives machines nothing. Input: url; optional variant, quantity, ship_to, language.","last_updated":"2026-09-27T03:09:57.245Z","schemes":["exact"]}