Visão geral

A OmniLink API converte URLs de produto em links de afiliado e faz scraping de listagens e páginas de produto nas plataformas Amazon, Mercado Livre e Shopee.

A partir da versão 1.4, use POST /v1/fetch/{platform}/product para um único anúncio (PDP). O /list continua sendo grade de ofertas ou busca por tema.

Distribuição: imagem Docker + OpenAPI. Sem acesso ao código-fonte.

automacaodebaixocusto/omnilink-api:latest

As operações pesadas rodam em tasks Celery. O POST devolve 202 com task_id; consulte em GET /v1/tasks/{task_id}/status.

Começar

Base URL

Local (compose):

http://localhost:8000

Em Swarm a URL pública vem do Traefik (seu domínio).

Fluxo rápido

1. Suba com Docker local ou Swarm
2. Grave credenciais no cofre: POST /v1/accounts
3. Enfileire o trabalho: POST /v1/affiliate/{platform}/generate-link, POST /v1/fetch/{platform}/list ou POST /v1/fetch/{platform}/product
4. Acompanhe: GET /v1/tasks/{task_id}/status
5. Opcional: webhook com HMAC X-Omnilink-Signature

Plataformas

Referência da API