costco

What problem does it solve?

This Skill bypasses Akamai-protected category pages on costco.com by replaying the site's public catalog search API so you can retrieve full product grids and metadata without rendering or interacting with the blocked HTML.

Core Features & Use Cases

• Direct API Replay: Reconstructs the POST to gdx-api.costco.com/catalog/search/api/v1/search to fetch category listings without using a browser.
• Accurate Extraction: Parses searchResult.results and variantRollupValues for product id, title, brand, pricing, promo text, availability, rating, and canonical URLs.
• Efficient Pagination: Uses offset and pageSize (tested up to 96) to iterate large categories quickly and avoid N+1 per-item calls. Use case: reliably scrape /laptops.html or other category pages to produce a complete catalog export for downstream processing.

Quick Start

Send a single POST request to https://gdx-api.costco.com/catalog/search/api/v1/search with a JSON body containing the category filter and pageSize, and include headers content-type, client_id: USBC, client-identifier (UUID), searchresultprovider, origin, referer, and a plausible user-agent to receive searchResult.results in the response.