A API Costco Search devolve listagens de produtos a partir de sites regionais do Costco. Passe uma palavra-chave, URL de pesquisa completa ou palavra-chave com region e receba preços, disponibilidade, número de reviews e paginação em JSON.
A Piloterr usa renderização no navegador. 2 créditos por chamada. Use url dos resultados com Costco Product para dados PDP completos.
us, fr, es, ca, uk, mx, kr, tw, jp, au, is, nz, se
UK usa page=; a maioria das regiões usa currentPage=.
GET https://api.piloterr.com/v2/costco/search?query=home
GET https://api.piloterr.com/v2/costco/search?query=home®ion=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=home®ion=ca&page=2
| Parâmetro |
Tipo |
Obrigatório |
Descrição |
query |
string |
sim |
Palavra-chave ou URL pesquisa regional completa |
region |
string |
não |
Código região ou host com palavra-chave (predefinição: US) |
page |
integer |
não |
Número de página a partir de 1 |
return_page_source |
boolean |
não |
HTML bruto como {"result": "..."} |
| Campo |
Tipo |
Descrição |
product_id / title / url |
string |
ID catálogo, título, URL produto |
price / currency |
number / string |
Preço exibido, moeda ISO |
review_count / availability |
integer / string |
Número reviews, ex. delivery |
region |
string |
Host regional |
- Costco Search (este endpoint) para descobrir listagens
- Costco Product para dados PDP completos
- Monitorização de preços multi-região em US, CA, UK, FR e mais
- Descoberta de catálogo: recolher
product_id e URLs em escala
- Acompanhamento de ranking de pesquisa por palavra-chave e região