Enfileira scraping de listagem (ou busca Shopee Open API) — Shopee
Cria uma task `kind=scraping` (`run_scraping_task`). - **amazon / mercadolivre:** `url` e `selectors` obrigatorios (Playwright em cards de listagem). Para URL de pagina de produto (PDP), use `POST /v1/fetch/{platform}/product` — o `/list` procura cards e pode voltar `items: []`. - **shopee:** `keyword` obrigatorio (Open API productOfferV2); `url`/`selectors` nao sao usados. Requer conta Shopee completa no cofre. `limit_products` e limitado a 50 no worker. `shopee_page` default 1; `shopee_sort_type` opcional. Para um anuncio especifico pela URL, use `POST /v1/fetch/shopee/product`. Webhook: `webhook_override` ou `webhook_url` da conta.
Cria uma task kind=scraping (run_scraping_task).
- amazon / mercadolivre:
urleselectorsobrigatorios (Playwright em cards de listagem). Para URL de pagina de produto (PDP), usePOST /v1/fetch/{platform}/product— o/listprocura cards e pode voltaritems: []. - shopee:
keywordobrigatorio (Open API productOfferV2);url/selectorsnao sao usados. Requer conta Shopee completa no cofre.limit_productse limitado a 50 no worker.shopee_pagedefault 1;shopee_sort_typeopcional. Para um anuncio especifico pela URL, usePOST /v1/fetch/shopee/product. Webhook:webhook_overrideouwebhook_urlda conta.
Authorization
ApiKeyAuth Tenant key. Nao e JWT. Qualquer valor nao-vazio identifica um tenant via SHA-256. Ausencia => 401 API key ausente. Nao ha lista de chaves validas.
In: header
Header Parameters
Identificador do tenant. Qualquer string nao-vazia e aceita; a API armazena apenas o SHA-256. Nao ha cadastro/validacao de chave. Chave diferente = tenant diferente (isolamento).
1 <= lengthRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/fetch/shopee/list" \ -H "x-api-key: sua-api-key" \ -H "Content-Type: application/json" \ -d '{ "keyword": "fone bluetooth", "limit_products": 20, "shopee_page": 1, "shopee_sort_type": 1 }'Enfileira scraping de listagem (ou busca Shopee Open API) — Amazon POST
Cria uma task `kind=scraping` (`run_scraping_task`). - **amazon / mercadolivre:** `url` e `selectors` obrigatorios (Playwright em cards de listagem). Para URL de pagina de produto (PDP), use `POST /v1/fetch/{platform}/product` — o `/list` procura cards e pode voltar `items: []`. - **shopee:** `keyword` obrigatorio (Open API productOfferV2); `url`/`selectors` nao sao usados. Requer conta Shopee completa no cofre. `limit_products` e limitado a 50 no worker. `shopee_page` default 1; `shopee_sort_type` opcional. Para um anuncio especifico pela URL, use `POST /v1/fetch/shopee/product`. Webhook: `webhook_override` ou `webhook_url` da conta.
Enfileira pagina de produto (PDP) — um unico item — Mercado Livre POST
Cria uma task assincrona (`202` + `task_id`). Consulte `GET /v1/tasks/{task_id}/status`. O `/list` continua sendo listagem (varios cards ou busca por tema). O `/product` devolve **um unico produto** a partir da URL. Nao envie `limit_products`: sempre e um item. - **amazon / mercadolivre:** Playwright na PDP. `url` + `selectors` obrigatorios. `||` nos seletores e fallback (tenta o primeiro CSS; se vazio, o proximo). `link` nao precisa de seletor: a API preenche com a URL canonica. Campos vazios podem ser completados com JSON-LD / Open Graph. Cookies do cofre entram automaticamente, se existirem. - **shopee:** Open API de afiliados (`productOfferV2`). **Nao usa Playwright nem seletores.** Body: so `url`. Extrai `shopId`/`itemId` da URL (ou resolve short link `s.shopee.com.br`) e consulta por `itemId`. Requer conta Shopee no cofre (`affiliate_id` = App ID, `cookies` = secret). Se o item nao estiver no catalogo de ofertas da afiliacao, `count` vem `0`. Webhook: `webhook_override` no body ou `webhook_url` da conta da mesma plataforma. Assinatura `X-Omnilink-Signature`.