Busca
Busque produtos ou resolva um link de marketplace colado.
GET /api/v1/search exige um token bearer. Usa a mesma lógica de busca da loja e do app, sem gravar o histórico do cliente ou de visitas.
curl --get https://www.ninjabuy.com/api/v1/search \
-H "Authorization: Bearer $NINJABUY_ACCESS_TOKEN" \
--data-urlencode "q=hoodie" \
--data-urlencode "provider=taobao" \
--data-urlencode "page=0"Parâmetros de consulta
| Parâmetro | Regras |
|---|---|
q | Obrigatório, sem espaços nas extremidades. Palavras-chave: de 2 a 120 caracteres. Links colados: até 2.048 caracteres. |
provider | taobao (padrão) ou a1688. |
page | Inteiro de 0 a 20, começando em zero; padrão: 0. |
Envie cada parâmetro uma única vez. Parâmetros inválidos ou repetidos retornam 400 com o problema bad-body.
Tipos de resposta
Toda resposta bem-sucedida tem kind e request_id.
kind | Campos e significado |
|---|---|
products | Resultados por palavras-chave: items, page, pageSize, totalCount, maximumPageCount e unread (um objeto com o host de um link colado que não pôde ser lido; caso contrário, null). |
product | Um produto: handle e url na loja. Um link colado ou uma busca por identificador de item pode resolver diretamente para esse tipo. |
vendor | Uma loja resolvida: vendor. |
sheet | Uma planilha Google reconhecida: sheetId e gid, que pode ser null; sem conteúdo da planilha. |
unsupported | Um link reconhecido, mas não compatível: link contendo marketplace e id. |
Cada item de products contém handle, url na loja, title, price: { amount, currency: "CNY" }, image (pode ser null) e marketplace (taobao ou a1688). amount é uma string decimal em yuans chineses, igual à grade da loja. As URLs de busca são URLs de produtos comuns; use Links para criar links com atribuição.
Consumo e limites de requisições
Links colados usam o resolvedor anônimo e não podem contratar um desbloqueio pago da Bright Data. Links reconhecidos de produtos, lojas, planilhas e sites não compatíveis pulam a busca por palavras-chave. Um link colado que não pôde ser lido pode passar à busca por palavras-chave e consumir cota de busca da OT.
Buscas por palavras-chave têm um limite próprio de 30 chamadas por conta a cada 60 segundos, separado das chamadas de criação de links. As respostas bem-sucedidas que chegam à admissão de busca por palavras-chave e as recusas por limite de busca incluem:
RateLimit-Policy: "search";q=30;w=60
RateLimit: "search";r=29;t=60Uma recusa retorna 429, o problema search-rate-limited e Retry-After em segundos. Links colados resolvidos não consomem nenhuma janela nem incluem cabeçalhos de limite de busca. Toda resposta inclui X-Request-Id e Cache-Control: no-store. Veja Limites de requisições para os campos dos cabeçalhos.