Costco Search API

OverviewLink to Overview

The Costco Search API returns product listings from Costco regional sites. Pass a keyword, a full search URL, or a keyword with region and receive structured JSON with prices, availability, review counts, and pagination.

Piloterr uses browser rendering (wait_for=#costco-consent-manager, ~8s) to load search result tiles across supported regional hosts.

Use each result url with Costco Product for full PDP data (brand, description, images, breadcrumbs).

Supported regionsLink to Supported regions

CA and UK use dedicated search URL formats; other regions follow the US-like /s?keyword= pattern.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/costco/search?query=home
GET https://api.piloterr.com/v2/costco/search?query=home&region=fr
GET https://api.piloterr.com/v2/costco/search?query=https://www.costco.co.uk/search?text=sonos
GET https://api.piloterr.com/v2/costco/search?query=https://www.costco.ca/CatalogSearch?keyword=home&currentPage=2

Via POST:

POST https://api.piloterr.com/v2/costco/search
Content-Type: application/json

{"query": "home", "region": "fr", "return_page_source": false}

ParametersLink to Parameters

Input formatsLink to Input formats

Response: each listing (results[])Link to Response: each listing (results[])

Response: paginationLink to Response: pagination

Costco API workflowLink to Costco API workflow

1. Costco Search: discover listings by keyword or URL (this endpoint)
2. Costco Product: fetch full PDP JSON from any result url or product ID

Error codesLink to Error codes

NotesLink to Notes

• UK pagination uses page=; most other regions use currentPage=.
• Costs 2 credits per call (browser rendering).

Main use casesLink to Main use cases

• Multi-region repricing: monitor Costco prices across US, CA, UK, FR, and more
• Catalog discovery: harvest product_id and URLs at scale
• Search rank tracking: track listing visibility by keyword and region