OmniLink API
Fetch

Enfileira scraping de listagem (ou busca Shopee Open API) — Mercado Livre

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.

POST
/v1/fetch/mercadolivre/list

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.

Authorization

ApiKeyAuth
x-api-key<token>

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

x-api-key*string

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).

Length1 <= length

Request 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/mercadolivre/list" \  -H "x-api-key: sua-api-key" \  -H "Content-Type: application/json" \  -d '{    "url": "https://www.mercadolivre.com.br/ofertas",    "limit_products": 5,    "selectors": {      "container": ".poly-card",      "titulo": ".poly-component__title",      "preco": ".poly-price__current .andes-money-amount__fraction||.andes-money-amount__fraction",      "link": "a.poly-component__title||a",      "imagem": "img",      "next_page": ".andes-pagination__button--next"    }  }'
Empty

Resolve URL canonica e gera link de afiliado POST

Mesmo body e regras de conta que generate-link. Cria tasks `kind=affiliate_convert` (`run_affiliate_convert_task`): resolve short/social/afiliado para URL canonica e gera o link com a tag da conta. Nao altera generate-link.

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.