A API Action Search devolve listagens de produtos do Action.com. Passe uma palavra-chave ou URL de pesquisa completa, opcionalmente com region, e receba preços, imagens, locale, moeda e paginação em JSON.
A Piloterr usa renderização no navegador para páginas de pesquisa Next.js RSC. 2 créditos por chamada.
Use url ou product_id dos resultados com Action Product para dados PDP completos.
GET https://api.piloterr.com/v2/action/search?query=meuble
GET https://api.piloterr.com/v2/action/search?query=meuble®ion=fr-fr
GET https://api.piloterr.com/v2/action/search?query=cabide®ion=pt-pt&page=2
| Parâmetro |
Tipo |
Obrigatório |
Descrição |
query |
string |
sim |
Palavra-chave ou URL pesquisa Action completa |
region |
string |
não |
Locale ou código país (predefinição: fr-fr) |
page |
integer |
não |
Número de página a partir de 1 (predefinição: 1) |
return_page_source |
boolean |
não |
HTML bruto como {"result": "..."} |
| Campo |
Tipo |
Descrição |
product_id / title / url |
string |
Código artigo, nome, URL produto |
price / currency |
number / string |
Preço c/ IVA, moeda ISO |
image_url / locale |
string |
Imagem principal, locale usado |
- Action Search (este endpoint) para descobrir listagens
- Action Product para dados PDP completos
- Monitorização de preços em listagens Action em locales europeus
- Descoberta de catálogo: recolher
product_id e URLs em escala
- Análise retail cross-border: comparar disponibilidade e preços por região