Localização de e-commerce

Aprenda a fazer scraping de dados de e-commerce adaptados a locais específicos de entrega e loja.

Nossa Web Scraper API oferece opções de localização para recuperar dados de e-commerce personalizados para locais específicos de entrega e lojas. Esta página explica como usar o geo_location e store_id e outros parâmetros para alinhar os resultados com disponibilidade e preferências locais.

Suporte de Localização Específico por Site

Domain	Localização geográfica / Entrega	ID da loja	Tipo de atendimento
Allegro	-	Suportado	-
Amazon	CEP ou código do país de 2 letras	-	-
Bestbuy	CEP	Suportado	Suportado
Bodega Aurrerá	CEP	Suportado	Suportado
Etsy	CEP ou código do país de 2 letras	Suportado	-
Kroger	CEP	Suportado	Suportado
Lowes	CEP	Suportado	-
Menards	-	Suportado	-
Petco	-	Suportado	Suportado
Publix	-	Suportado	-
Sam's Club	CEP	Suportado	Suportado
Target	CEP	Suportado	Suportado
The Home Depot	CEP ou país	Suportado	-
Walmart	CEP ou país	Suportado	Suportado

Allegro

Adaptar resultados para lojas específicas, locais de envio, etc.

Defina o delivery_type

Defina o shipping_from

Defina store_city e store_region

Parâmetro	Descrição	Tipo
delivery_time	Defina a data de entrega. Valores disponíveis são: one_day, two_days.	String
shipping_from	Defina o local de origem do envio. Valores disponíveis são: china, czech, poland, hungary, slovakia, eu_countries, allegro_warehouse.	String
store_city	Defina a cidade da loja.	String
store_region	Defina a região da loja de envio. Valores disponíveis são: "lodz", "opole", "lublin", "mazovia", "silesia", "lubuskie", "podlaskie", "pomerania", "subcarpathia", "lesser_poland", "lower_silesia", "greater_poland", "warmia-masuria", "west_pomerania", "Świętokrzyskie", "kuyavian-pomeranian"	String

Amazon

Usando o geo_location parâmetro personaliza os resultados da Amazon com base nas preferências de entrega, como mostrado nas capturas de tela abaixo:

Para a maioria dos domínios da Amazon, você pode definir geo_location com um CEP/código postal ou um código do país de 2 letras. Exceto por alguns casos, essa abordagem cobre dois cenários principais de localização:

• Use um CEP/código postal para locais dentro de do país do marketplace. Exemplos de pares:

  • { "domain": "com", "geo_location": "90210" }

  • { "domain": "co.uk", "geo_location": "W105LT" }

• Use um código do país de 2 letras para locais fora de do país do marketplace. Exemplos de pares:

  • { "domain": "com", "geo_location": "LT" }

  • { "domain": "de", "geo_location": "US" }

Exceções

• Domínios não suportados: cn, com.tr, com.be, e nl não suportam locais de entrega personalizados.

• Casos Especiais:

  • Austrália (com.au): Aceita apenas códigos postais australianos.

  • EAU (.ae): Aceita nomes de cidades dos Emirados como geo_location, por exemplo, "geo_location": "Abu Dhabi", ou códigos de país de 2 letras.

Você também pode usar domain e locale parâmetros ao raspar a Amazon. Saiba mais aqui.

Bestbuy

Adaptar resultados para domínios específicos, lojas, locais de entrega.

Parâmetro	Descrição	Valor Padrão	Tipo
domain	Localização por domínio para Bestbuy. Valores disponíveis: com, ca.	com	String
store_id	Especificar uma loja.	-	Integer
delivery_zip	Defina o CEP de entrega.	-	String
fulfillment_type	Especificar método de atendimento do pedido. Valores disponíveis: pickup, shipping	-	String

Etsy

Adaptar resultados para lojas específicas, locais de entrega.

Selecionar store_id

Selecionar local de entrega

Parâmetro	Descrição	Tipo
store_id	Especificar uma loja.	Integer
geo_location	Defina o local de envio.	String

Kroger

Parâmetro	Descrição	Valor Padrão	Dependências
store_id	Especifique uma loja. Veja os valores disponíveis aqui. O ID deve começar com '0'.	-	Obrigatório quando fulfillment_type está definido como pickup ou in_store.
delivery_zip	Especifique o CEP do local de entrega.	-	Obrigatório quando fulfillment_type está definido como delivery.
fulfillment_type	Especificar método de atendimento do pedido. Valores disponíveis: pickup, delivery, in_store.	pickup (se apenas store_id for fornecido)	Requer store_id . Observe que no momento só suportamos saída analisada para pickup e in_store, ou delivery_zip . Observe que no momento só suportamos saída analisada para delivery.

Dependências explicadas:

• pickup e in_store valores usam o store_id parâmetro para determinar a loja correta.

• delivery usa o delivery_zip parâmetro para especificar o local de entrega.

• Se apenas store_id for fornecido, e fulfillment_type não for especificado, o tipo padrão é pickup.

Se a fulfillment_type e store_id/delivery_zip combinação for inválida (não suportada pelo Kroger), a página raspada retornará com status 404.

Observe que o parâmetro contextual não é necessário para definir o ID da loja com fontes Kroger, ao contrário de outras fontes.

Lowe's

Selecionar store_id

Parâmetro	Descrição	Tipo
store_id	Especificar uma loja.	Integer
delivery_zip	Especifique o CEP do local de entrega.	String

Menards

Adaptar resultados para lojas específicas, opções de disponibilidade.

Selecionar store_id

Selecionar opções de disponibilidade

Parâmetro	Descrição	Tipo
store_id	Especificar uma loja.	String
pickup_at_store_eligible	Retirada disponível na loja.	Boolean
in_stock_today	O item está em estoque hoje.	Boolean
fulfillment_center	O pedido pode ser enviado a partir de um depósito centralizado da Menards.	Boolean
delivery_eligible	O item se qualifica para serviço de entrega em domicílio.	Boolean

Petco

Adaptar resultados para lojas específicas, tipos de atendimento.

Selecionar store_id

Selecionar fulfillment_type

Parâmetro	Descrição	Tipo
store_id	Especificar uma loja.	String
fulfillment_type	Especifique o método de atendimento do pedido. Valores disponíveis são: repeat_delivery, free_pickup_today, same_day_delivery.	Boolean

Publix

Adaptar Publix resultados com base nas localizações das lojas.

Parâmetro	Descrição	Tipo
store_id	Especifique uma loja. Veja os valores disponíveis aqui.	Integer

Target

Selecionar geo_location e store_id

Selecionar fulfillment_type

Parâmetro	Descrição	Tipo
store_id	Especificar uma loja.	String
fulfillment_type	Especifique o método de atendimento do pedido. Valores disponíveis são: pickup, shop_in_store, same_day_delivery, shipping.	Boolean

The Home Depot

Use o geo_location parâmetro para definir o local de entrega por cep ou country.

Você também pode adicionar store_id no parâmetro context para dados específicos da loja. O Store ID deve ser um número de 4 dígitos. Por exemplo, se o Store ID for um número de 3 dígitos, prefixe-o com um zero (por exemplo, 618 -> 0618). Encontre a lista de IDs de lojas do Home Depot aqui.

...
"geo_location": "29576",
"context": [
    {
        "key": "store_id",
        "value": "2214"
    }
]
...  

Walmart

Use o delivery_zip parâmetro para especificar locais de entrega do Walmart com base em cep.

Você também pode adicionar store_id parâmetro para dados específicos da loja. Encontre a lista de IDs de lojas do Walmart aqui:

294KB

www_walmart_com_stores.csv

Abrir

A página oficial das lojas Walmart é aqui.

...
"delivery_zip": "60805",
"store_id": "2070"
...  

Domínios internacionais do Walmart

A localização também é suportada para os seguintes domínios do Walmart. Use delivery_zip e store_id como parâmetros de contexto para definir o local de entrega ou retirada e direcionar uma loja específica.

Para walmart.com, walmart.com.mx, e walmart.ca, você também pode passar fulfillment_type como parâmetro de contexto para definir o método de atendimento.

Domain	Supported fulfillment types
walmart.com	pickup, delivery, shipping
walmart.com.mx	pickup, delivery
walmart.ca	pickup, delivery
walmart.co.cr	pickup

"context": [
    { "key": "delivery_zip", "value": "06600" },
    { "key": "store_id", "value": "1015" },
    { "key": "fulfillment_type", "value": "delivery" }
]

Encontre os store_id valores disponíveis para cada domínio abaixo:

38KB

www_walmart_com_mx_stores.csv

Abrir

24KB

www_walmart_ca_stores.csv

Abrir

Para walmart.co.cr, o tipo de atendimento é sempre pickup. Use delivery_zip e store_id para direcionar um local específico.

"context": [
    { "key": "delivery_zip", "value": "10101" },
    { "key": "store_id", "value": "4413" }
]

Encontre os store_id valores para o local da Costa Rica abaixo:

126B

walmart_co_cr_stores.json

Abrir

Bodega Aurrerá

Use o delivery_zip parâmetro para definir o local de entrega ou retirada por CEP para despensa.bodegaaurrera.com.mx domínio somente. Você também pode especificar uma loja com store_id e selecionar um método de atendimento com fulfillment_type.

Parâmetro	Descrição	Tipo
delivery_zip	Defina o local de entrega ou retirada. Aceita um código postal mexicano.	String
store_id	Especificar uma loja.	String
fulfillment_type	Defina o método de fulfillment. Valores disponíveis: pickup, delivery.	String

"delivery_zip": "06600",
"context": [
    { "key": "store_id", "value": "383" },
    { "key": "fulfillment_type", "value": "delivery" }
]

Encontre os IDs de lojas disponíveis da Bodega Aurrerá abaixo:

23KB

despensa_bodegaaurrera_com_mx_stores.json

Abrir

Sam's Club

A localização é suportada tanto para samsclub.com (EUA) e sams.com.mx (México). Use os delivery_zip e store_id parâmetros de contexto para definir o local de entrega ou retirada e direcionar uma loja específica. Use fulfillment_type para selecionar o método de atendimento.

Parâmetro	Descrição	Tipo
delivery_zip	Defina o local de entrega ou retirada.	String
store_id	Especificar uma loja.	String
fulfillment_type	Defina o método de fulfillment. Valores disponíveis: delivery, pickup, shipping. Padrão: pickup.	String

"context": [
    { "key": "delivery_zip", "value": "60601" },
    { "key": "store_id", "value": "4702" },
    { "key": "fulfillment_type", "value": "pickup" }
]

Encontre os store_id valores disponíveis para cada domínio abaixo:

38KB

www_samsclub_com_stores.csv

Abrir

16KB

www_sams_com_mx_stores.csv

Abrir