Localização de e-commerce

Aprenda a raspar 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 loja. Esta página explica como usar o geo_location e store_id e outros parâmetros para alinhar os resultados com a disponibilidade e as preferências locais.

Suporte de localização específico por site

Domínio	Localização geográfica / Entrega	ID da loja	Tipo de fulfillment
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	-
Publix	-	Suportado	-
Sam's Club	CEP	Suportado	Suportado
Destino	CEP	Suportado	Suportado
The Home Depot	CEP ou código do país	Suportado	-
Walmart	CEP ou código do país	Suportado	Suportado

Allegro

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

Defina o delivery_type

Defina a localização shipping_from

Defina store_city e store_region

Parâmetro	Descrição	Tipo
delivery_time	Defina a data de entrega. Os valores disponíveis são: one_day, two_days.	String
shipping_from	Defina a origem do envio. Os valores disponíveis são: china, czech, poland, hungary, slovakia, eu_countries, allegro_warehouse.	String
store_city	Defina a cidade da loja de compras.	String
store_region	Defina a região da loja de envio. Os 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 parametr 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 localizações dentro o país do marketplace. Pares de exemplo:

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

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

• Use um código do país de 2 letras para localizações fora o país do marketplace. Pares de exemplo:

  • { "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 EAU 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 fazer scraping da Amazon. Saiba mais aqui.

Bestbuy

Adapte os resultados para domínios, lojas e locais de entrega específicos.

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

Etsy

Adapte os resultados para lojas específicas, locais de entrega.

Selecione store_id

Selecione o local de entrega

Parâmetro	Descrição	Tipo
store_id	Especifique uma loja.	Inteiro
geo_location	Defina a origem do 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	Especifique o método de fulfillment do pedido. Valores disponíveis: pickup, delivery, in_store.	pickup (se apenas store_id for fornecido)	Requer store_id para pickup e in_store, ou delivery_zip 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 combinação fulfillment_type e store_id/delivery_zip for inválida (não suportada pelo Kroger), a página raspada retornará com um 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

Selecione store_id

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

Menards

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

Selecione store_id

Selecione opções de disponibilidade

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

Publix

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

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

Destino

Selecione geo_location e store_id

Selecione fulfillment_type

Parâmetro	Descrição	Tipo
store_id	Especifique uma loja.	String
fulfillment_type	Especifique o método de fulfillment do pedido. Os valores disponíveis são: pickup, shop_in_store, same_day_delivery, shipping.	Booleano

The Home Depot

Use o geo_location parâmetro para definir o local de entrega por código postal ou país.

Você também pode adicionar store_id no contexto parâmetro 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, acrescente um zero à esquerda (ex.: 618 -> 0618). Encontre a lista de Home Depot Store IDs aqui.

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

Walmart

Use o delivery_zip parâmetro para especificar os locais de entrega da Walmart com base em código postal.

Você também pode adicionar store_id parâmetro para dados específicos da loja. Encontre a lista de Walmart Store IDs 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 da Walmart

A localização também é suportada para os seguintes domínios da 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 fulfillment.

Domínio	Tipos de fulfillment suportados
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 fulfillment é 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 a localidade 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 apenas o domínio. Você também pode especificar uma loja com store_id e selecionar um método de fulfillment 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	Especifique 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 abaixo os IDs de loja disponíveis da Bodega Aurrerá:

23KB

despensa_bodegaaurrera_com_mx_stores.json

Abrir

Sam's Club

A localização é suportada para ambos 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 fulfillment.

Parâmetro	Descrição	Tipo
delivery_zip	Defina o local de entrega ou retirada.	String
store_id	Especifique 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