{"uid":"cap_qhrBYranAu6A5tWEf1Ocv","slug":"costco-product-scraper-api-x402-fe44ea05","name":"Costco Product Scraper API (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/v1/costco?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"keyword":{"type":"string","description":"Search Costco products by keyword. Runs alongside any start URLs."},"maxItems":{"type":"integer","default":0,"minimum":0,"description":"Maximum products across all inputs. Set to 0 for no total limit."},"startUrls":{"type":"array","default":[],"description":"Costco search, category, or product URLs to scrape. May be used together with a keyword."},"warehouseId":{"type":"string","default":"847","description":"Warehouse number used for location-specific pricing and availability. The default is a Seattle-area warehouse."},"deliveryState":{"type":"string","default":"WA","description":"Two-letter US state code corresponding to the delivery ZIP code."},"deliveryZipCode":{"type":"string","default":"98101","description":"US delivery ZIP code used for shipping prices and availability."},"maxProductsPerUrl":{"type":"integer","default":30,"minimum":1,"description":"Maximum number of products from each keyword or listing URL; a product URL returns at most one."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"id":null,"name":null,"groupId":null,"itemNumber":null,"productUrl":null,"description":null,"manufacturingSkus":null,"variantItemNumbers":null}],"product":"costco"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AF6cqyX0XLb2_ZYFkNTUX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes structured product data from Costco.com by keyword search or URL, including pricing and availability for a specified warehouse and delivery location.","exampleAgentPrompt":"Search Costco for 'organic olive oil', return up to 20 products available for delivery to ZIP code 90210 in CA, and give me the item numbers, names, and descriptions.","exampleUseCases":[{"title":"Price comparison for Costco products","prompt":"Search Costco for 'protein powder' and get me the first 15 results with item numbers and descriptions — I'm in Seattle so use the default warehouse and ZIP 98101 in WA."},{"title":"Costco category page scraping","prompt":"Scrape this Costco category page https://www.costco.com/patio-furniture.html and return up to 30 products with their names, item numbers, and product URLs."},{"title":"Warehouse-specific availability lookup","prompt":"Look up Costco products matching 'air purifier' for warehouse 1228 in Austin TX, ZIP 78701, and return up to 10 results with full product details."}],"resultDescription":"A JSON object containing a count of matched products and an array of product items, each with fields for product ID, name, group ID, item number, product URL, description, manufacturing SKUs, and variant item numbers. The 'product' field identifies the source as 'costco'.","failureModes":["Empty results if keyword or URL matches no Costco products — not charged","Costco website changes breaking scraper structure — may return partial or malformed data","Invalid or inaccessible URL inputs returning empty items array","Invalid warehouse ID or ZIP code causing availability lookups to fall back to defaults or fail","Rate limiting or blocking by Costco's anti-bot measures"],"whenToPreferThis":"Choose this endpoint when you need structured Costco product data — including item numbers, SKUs, and location-specific pricing — without building your own scraper. It is pay-per-call with no charge for empty runs, making it cost-efficient for exploratory or infrequent queries. Prefer it over general-purpose web scraping APIs when you specifically need Costco product catalog data with warehouse and delivery filtering.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:36.717Z","isFirstParty":false,"canonicalSlug":"costco-product-scraper-api-x402-fe44ea05"}