{"uid":"cap_VUuUpXesltU3cCNQjHnsv","slug":"forest-commerce-buyability-check-dfab5c5d","name":"Forest Commerce Buyability Check","description":"Report whether a public item appears buyable with explicit blockers such as out-of-stock or unknown. This is a preflight only: it never signs in, buys, creates an order or guarantees checkout. Base mainnet USDC","url":"https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/commerce/buyability?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","pattern":"^https?://","maxLength":2048,"description":"Public HTTP(S) URL to inspect, resolve, or compare."},"variant":{"type":"object","description":"Public identifiers value used to scope this lookup.","additionalProperties":true},"quantity":{"type":"integer","maximum":100,"minimum":1,"description":"Requested item quantity to validate against provider limits."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PXm41IB0LukqMNiiLmz9r","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether a public marketplace item appears purchasable, returning explicit blockers like out-of-stock status without signing in or placing any order.","exampleAgentPrompt":"Before I try to buy it, can you check if this product URL is actually buyable right now — I want quantity 2 of the blue variant: https://www.example.com/product/12345?","exampleUseCases":[{"title":"Pre-purchase availability gate","prompt":"Check if this Amazon listing is buyable for quantity 3 before I proceed: https://www.amazon.com/dp/B09XYZ1234 — I need to know if there are any blockers like out-of-stock or purchase limits."},{"title":"Variant-specific stock check","prompt":"Can you tell me if this sneaker listing is purchasable right now for size 10 (variant id: size-10-black) at https://www.nike.com/t/air-max-270/ABC123? I only need 1 pair."},{"title":"Agent workflow buyability preflight","prompt":"Before my shopping agent tries to check out, verify that https://www.ebay.com/itm/987654321 is currently buyable — quantity 1 — and surface any explicit blockers like out-of-stock or seller restrictions."}],"resultDescription":"Returns a buyability status indicating whether the public item appears purchasable, along with any explicit blockers detected (e.g. out-of-stock, quantity limits exceeded, unknown status). Does not guarantee successful checkout and never initiates a purchase or login.","failureModes":["URL is not a recognized marketplace product page — returns unknown or error status","Item page requires authentication to view availability — blocker reported as unknown","Network timeout or unreachable URL — error response","Requested quantity exceeds provider limits (max 100) — validation error","Dynamic or JavaScript-rendered pages may not expose stock signals — result may be inconclusive"],"whenToPreferThis":"Use this endpoint when you need a lightweight, read-only preflight check on whether a public product URL appears buyable before committing to a checkout flow. Prefer this over the cart-checkout endpoint when you want a fast signal without even attempting to build a cart. Best when you need to detect hard blockers (out-of-stock, unavailable variants) early in an automated purchasing workflow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:08:51.942Z","isFirstParty":false,"canonicalSlug":"forest-commerce-buyability-check-dfab5c5d"}