Endpoints do Amazon Scraper
Use o ator scraper.amazon para todas as operações nesta página. Selecione a operação com input.type e forneça suas entradas correspondentes.
Solicitação e autenticação
POST https://api.scrapeless.com/api/v1/scraper/request
x-api-token: YOUR_API_KEY
Content-Type: application/jsonSubstitua YOUR_API_KEY pela sua chave de API da Scrapeless. Envie um único objeto JSON contendo actor e input.
Escolha uma operação
| Operação | input.type | Entradas usadas abaixo |
|---|---|---|
| Produto | product | url, zip_code |
| Vendedor | seller | url, zip_code |
| Pesquisa por palavras-chave | keywords | keywords, page, domain, zip_code |
| Rufus | rufus | keywords, domain |
Produto
Forneça um URL de produto da Amazon. O schema de Produto exige url; zip_code fornece informações sobre o local de entrega.
curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
--header 'x-api-token: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"actor": "scraper.amazon",
"input": {
"type": "product",
"url": "https://www.amazon.com/dp/B0BQXHK363",
"zip_code": ""
}
}'A resposta publicada inclui asin, title, availability, final_price, rating, reviews_count, images e variations. Consulte Quickstart para um exemplo de resposta resumido.
Vendedor
Forneça um URL da página do vendedor. Inclua zip_code: o schema de Vendedor o marca como obrigatório e seu exemplo de solicitação usa uma string vazia.
curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
--header 'x-api-token: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"actor": "scraper.amazon",
"input": {
"type": "seller",
"url": "https://www.amazon.com/sp?seller=A2XZ7JICGUQ1CX",
"zip_code": ""
}
}'A referência do Vendedor define a resposta bem-sucedida como um objeto JSON sem um schema ou exemplo em nível de campo. Inspecione o payload retornado antes de mapear os campos do vendedor em seu aplicativo.
Pesquisa por palavras-chave
Forneça o texto de pesquisa em keywords. Use page para selecionar uma página de resultados de pesquisa. O exemplo abaixo segue o valor numérico de página documentado e usa domain: "com" para a Amazon.com; ele omite o filtro opcional de departamento.
curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
--header 'x-api-token: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"actor": "scraper.amazon",
"input": {
"type": "keywords",
"keywords": "Iphone+14+Pro+512GB",
"page": 1,
"domain": "com",
"zip_code": ""
}
}'| Entrada | Uso |
|---|---|
keywords | Palavras-chave de pesquisa; obrigatório pelo schema da operação. |
page | Número da página de resultados da pesquisa. |
domain | Configuração de domínio da Amazon; o exemplo oficial usa com. |
department | Alias opcional de departamento, correspondente ao parâmetro de consulta i da Amazon. |
zip_code | Código postal para informações de entrega. |
A resposta publicada contém keyword, page, result, total_results_count e url. As entradas de produto aparecem em result.organic. O exemplo de resposta refere-se a uma consulta e página diferentes do exemplo de solicitação, portanto, deve ser usado para compreender os campos em vez de prever resultados exatos.
O guia de parâmetros da Amazon especifica valores inteiros para page, e o exemplo de solicitação usa 1; o schema de operação gerado atualmente rotula page como uma string. Este guia segue o guia de parâmetros e o exemplo de solicitação.
Referência da API de pesquisa por palavras-chave
Rufus
Defina type como rufus. Tanto keywords quanto domain são obrigatórios pelo schema da operação. Use um domínio completo da Amazon, como www.amazon.es, em vez do formato com usado no exemplo de Pesquisa por palavras-chave.
curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
--header 'x-api-token: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"actor": "scraper.amazon",
"input": {
"type": "rufus",
"keywords": "macbook",
"domain": "www.amazon.es"
}
}'A resposta publicada contém:
| Campo | Conteúdo mostrado no exemplo da API |
|---|---|
html | Conteúdo bruto contendo registros de eventos e fragmentos HTML. |
metadata | Inclui type e rawUrl. |
result.user_query | Texto da consulta. |
result.products | Entradas de produto retornadas para a consulta. |
result.related_questions | Perguntas relacionadas. |
result.sources | Fonte de dados; o campo pode não ser retornado em todas as respostas. Sua disponibilidade depende do produto e do prompt. |
O schema da operação também lista is_sse_data, is_get_question e asin, mas não explica seu comportamento. Comece com a solicitação documentada acima.
Gerenciar resultados de tarefas
Uma resposta HTTP 200 contém o resultado concluído. Uma resposta HTTP 201 significa que o processamento ainda está em andamento; salve o taskId e recupere essa tarefa com:
curl --request GET 'https://api.scrapeless.com/api/v1/scraper/result/YOUR_TASK_ID' \
--header 'x-api-token: YOUR_API_KEY'Substitua YOUR_TASK_ID pelo ID retornado pela sua solicitação. Consulte Resultados e Polling para intervalos de polling e limites de nova tentativa.
Inspecione os corpos de erro, bem como os códigos de status HTTP. Uma resposta 400 pode incluir code: 20500 e message: "scraping failed"; não se trata de uma resposta de dados bem-sucedida. Verifique o destino e as entradas da solicitação antes de tentar novamente.
Referência de parâmetros
Use Parâmetros da API Amazon para os aliases de departamento e outras entradas documentadas. Analise os resultados para o type selecionado; Produto, Pesquisa por palavras-chave, Vendedor e Rufus não compartilham um único layout de campos.