eBay Product Search

Search eBay auction and Buy-It-Now listings by query. Returns titles, bids, prices, and seller information.

Consulte cada endpoint com exemplos de requisição, parâmetros e o preço por requisição. Uma única chave de API chama todos; aplicam-se limites da conta.

Referência da API Abrir no Playground

Resumo

Endpoint: POST https://api.serpbase.dev/ebay/search
Preço: 1 créditos / solicitação
Autenticação: X-API-Key
Tipo de resultado: schemas.source_data

Endpoint e regras de cobrança

POSThttps://api.serpbase.dev/ebay/search

Custo por solicitação

1 créditos / solicitação

Cada solicitação usa o preço fixo do catálogo, não uma tarifa por página. Web Crawl e User Agent custam atualmente 1 crédito por solicitação cada; User Agent não é gratuito. A ausência real confirmada pela fonte e identidade do recurso é cobrada. no_results, HTTP 404 ou falta de hydration/dados analisados, isoladamente, não provam ausência. Falhas executadas podem consumir créditos; não há garantia de reembolso de todas as falhas. credits_charged informa a cobrança real: 0 indica zero; null ou campo ausente significa desconhecido. charge_status UNKNOWN permanece desconhecido mesmo com valor numérico. Confira os registros e contate o suporte com request_id; não presuma reembolso nem repita solicitações às cegas.

Exemplos de parâmetros

Os exemplos não são uma lista completa nem regras de obrigatoriedade. Campos conhecidos são validados e parâmetros adicionais são permitidos.

Exemplos de parâmetros
Parâmetro	Tipo do exemplo	Valor do exemplo
domain	string	"ebay.com"
query	string	"vintage watch"

JSON

{
  "domain": "ebay.com",
  "query": "vintage watch"
}

Os exemplos não são uma lista completa nem regras de obrigatoriedade. Campos conhecidos são validados e parâmetros adicionais são permitidos.
Alias	Parâmetro	Tipo
country	locale.country	string
cursor	pagination.cursor	string
device	options.device	string
gl	locale.country	string
hl	locale.language	string
html	include_html	boolean
language	locale.language	string
limit	pagination.limit	integer
markdown	include_markdown	boolean
mobile	options.device	boolean
num	pagination.limit	integer
page	pagination.page	integer
q	query	string

Dispositivos: desktop; padrão: desktop.

Exemplos de solicitações

cURL

curl -X POST 'https://api.serpbase.dev/ebay/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"domain":"ebay.com","query":"vintage watch"}'

JavaScript

const response = await fetch("https://api.serpbase.dev/ebay/search", {
  "method": "POST",
  "headers": {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY"
  },
  "body": "{\"domain\":\"ebay.com\",\"query\":\"vintage watch\"}"
});
const result = await response.json();
// Check result.status and result.error for the API outcome.
console.log(result);

Resposta e resultado da API

As respostas são JSON. HTTP 200 não prova sucesso: verifique status e error. Os campos dependem do contrato e dos dados de origem.

Ver documentação da resposta

Perguntas frequentes

Quanto custa a API de eBay Product Search?

Cada requisição custa 1 crédito. Os créditos vêm de pacotes pré-pagos ou do plano mensal, e contas novas começam com créditos grátis.

Como chamo a API de eBay Product Search?

Envie uma requisição POST para https://api.serpbase.dev/ebay/search com sua chave de API no cabeçalho X-API-Key. A resposta é JSON; verifique status (0 significa sucesso).

Quais dispositivos são suportados?

Dispositivos suportados: desktop. O padrão é desktop.

A API de eBay Product Search já está disponível?

Sim. Qualquer chave de API ativa pode chamá-la.