Um ID de item, um link
ou simplesmente o que você digitaria.

O que uma busca devolve
e o que não devolve.

Vale dois minutos antes de planejar uma execução, porque decide se você precisa de uma passada ou de duas.

O campo de entrada aceita três formas e as trata de modo diferente. Um ID de item puro e uma URL ebay.com/itm/… significam ambos este anúncio exato. Qualquer outra coisa é lida como termo de busca, e você recebe aquele conjunto de resultados - por isso existe position, e por isso o limite é descrito como valendo por consulta de busca em vez de por execução.

Sete colunas só chegam quando você pediu um item específico. Em cada linha de cada exportação que temos, availability, item_location, returns, seller_name, seller_feedback_percent, brand e type estavam preenchidas nas consultas por ID de item e por URL, e vazias nas buscas por palavra-chave. Não é um defeito: uma página de resultados não mostra essas coisas, então não há o que ler. Significa, sim, que um plano baseado em raspar uma busca para obter nomes de vendedor vai voltar vazio, e a solução é uma segunda passada sobre os IDs que a primeira devolveu.

Dois ajustes ficam ao lado da entrada e viajam para cada linha. country e postcode são o que você pediu - o site a pesquisar e o local de entrega contra o qual precificar -, ecoados na exportação para que um arquivo montado a partir de várias execuções continue autoexplicativo. Eles não dizem onde o item está. Isso é item_location, uma das sete acima.

Uma ressalva honesta sobre shipping. Normalmente traz texto de frete - Free shipping, Delivery: Varies, ou um valor. Em uma parcela considerável das linhas, porém, repete exatamente a string do preço, o que parece um artefato de parsing e não um frete que por acaso coincide. Trate a coluna como indicativa, compare-a com price antes de confiar numa linha, e não construa um cálculo de custo final em cima dela sem conferir sua própria exportação primeiro.

item_id

O identificador do próprio eBay para o anúncio, em dígitos. Presente em todas as linhas, e o valor com que a coluna url termina.

title

O título do anúncio como o vendedor escreveu. Presente em todas as linhas.

price

O preço como o anúncio o exibe, com símbolo e tudo - a string, não um número. Alguns anúncios mostram texto como See price em vez de um valor; veja currency abaixo.

price_parsed

O mesmo preço como número puro, ainda em string. É por esse que se ordena e compara. Fica vazio nas linhas em que o anúncio mostrou texto em vez de um valor.

currency

A moeda, normalmente um código de três letras, como coluna própria para que um arquivo que cubra vários sites do eBay continue comparável. Ressalva: onde o preço era texto em vez de valor, esta pega a primeira palavra no lugar de um código - filtre essas linhas com price_parsed.

condition

A condição como o anúncio declara, texto livre e não um conjunto fixo. Inclui -- onde nenhuma condição é informada.

availability

Quanto estoque o anúncio declara, como texto livre do tipo More than 10 available e não como número. Apenas em consultas por ID de item e URL - vazio em buscas por palavra-chave.

sold

Quantos foram vendidos, como número dentro de uma string. Presente em muitas linhas de busca e em algumas consultas de item; ausente onde o anúncio não mostra.

shipping

O frete como o anúncio apresenta - Free shipping, Delivery: Varies, ou um valor. Leia a nota acima: em uma parcela considerável das linhas isto repete a string do preço, então confira contra price antes de confiar.

item_location

De onde o item é enviado, como texto livre. Apenas em consultas por ID de item e URL. Isto - e não country - é a localização do item.

returns

As condições de devolução como uma frase de texto do anúncio. Apenas em consultas por ID de item e URL.

seller_name

O nome de exibição do vendedor. Apenas em consultas por ID de item e URL - uma busca por palavra-chave não o traz.

seller_feedback_percent

O percentual de avaliações positivas do vendedor, como string. Apenas em consultas por ID de item e URL.

brand

A marca como o anúncio declara. Apenas em consultas por ID de item e URL.

type

O tipo do item como o anúncio declara. Apenas em consultas por ID de item e URL.

image

Uma URL de imagem, a foto principal do anúncio, como string simples.

images

Um array JSON de URLs de imagem, não uma string com separadores - às vezes uma entrada, às vezes várias. Presente em todas as linhas.

url

O link canônico do anúncio. Em cada linha de cada exportação que temos ele termina com o item_id, o que torna seguro derivar um do outro.

country

O país que você pediu, ecoado em cada linha - um ajuste da execução, não um atributo do item.

postcode

O CEP de entrega que você pediu, ecoado em cada linha. Vazio quando você deixou o campo em branco.

position

Posição dentro dos resultados daquela consulta, como número e não como string. Recomeça em 1 para cada consulta, então ordene por query e depois por position para reconstruir uma página de resultados.

query

A entrada exata de onde esta linha veio - o ID, a URL ou o termo de busca que você enviou. Escrita pelo scraper, então está em todas as linhas; agrupe por ela sempre que um arquivo cobrir mais de uma entrada.

Esta página é incomum para nós: os formatos acima foram medidos, não descritos. Temos catorze exportações deste serviço com anúncios reais do eBay, e toda afirmação aqui vem de ler cada linha de cada uma delas. A lista de colunas é confiável por um motivo um pouco diferente do das nossas outras páginas: este serviço não declara nenhum array de colunas em lugar algum da plataforma, então a exportação é a única fonte - mas as catorze concordam exatamente: as mesmas vinte e três chaves, na mesma ordem, sem uma vigésima quarta. O que levar daqui é que sete das vinte e três só chegam quando você pede um item específico em vez de rodar uma busca, e são as de vendedor e detalhe do item. Planeje uma passada de busca para achar anúncios e uma passada de IDs para enriquecê-los, e confira shipping contra price na sua própria primeira exportação. Uma coluna está faltando acima de propósito. A exportação também traz seller_reviews, o que dá vinte e três, mas ela estava vazia em cada linha de cada execução que temos - então, em vez de descrever uma coluna da qual nunca vimos nada, mencionamos aqui e a deixamos fora da tabela.

O mesmo item,
em outro lugar.

Um preço só significa algo ao lado de outro preço. Estes devolvem dados de catálogo em formatos comparáveis.

O que as pessoas perguntam antes de se cadastrar.

As perguntas que mais ouvimos. Mais alguma coisa? Fale conosco - quem escreve as respostas são pessoas, não bots.