costco

Extract Costco product listings and metadata via the public catalog search API.

5|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/AgentComputerAI/torch --skill costco
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: costco
Source: https://github.com/AgentComputerAI/torch/tree/main/skills/sites/costco
Command: npx skills add https://github.com/AgentComputerAI/torch --skill costco

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about costco

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scrape Costco category listings when the HTML is blocked by Akamai?

To scrape Costco category listings blocked by Akamai, you can bypass the HTML shell and replay the site's public catalog search API at gdx-api.costco.com to fetch product data directly as JSON.

What is the best way to get product pricing and metadata from Costco without rendering a browser?

The best way to get product pricing and metadata from Costco without a browser is sending a POST request to the catalog search API and parsing the searchResult.results and variantRollupValues fields.

How do I handle pagination when scraping Costco product grids?

To handle Costco pagination, you include offset and pageSize parameters in your POST JSON body, iterating through large categories up to 96 items per page to avoid N+1 per-item calls.

What headers do I need to send to the Costco catalog search API?

You need headers including content-type, client_id set to USBC, a client-identifier UUID, searchresultprovider, origin, referer, and a plausible user-agent to successfully query the Costco catalog search API.

Does the Costco catalog API approach work for extracting product availability and ratings?

Yes, the Costco catalog API approach works for extracting availability and ratings, as the searchResult.results object contains product id, title, brand, pricing, promo text, and canonical URLs.

Why am I getting blocked trying to web scrape Costco category pages directly?

You are getting blocked because the category pages are Akamai-protected, but you can avoid this by querying the backend public gdx-api.costco.com endpoint that returns JSON without rendering HTML.