Documentação / API REST

API REST

Tudo que o MCP faz também é HTTP puro. Mesma engine, mesma conta, mesma comissão — autenticando com X-API-Key.

Base: https://mcpdoafiliado.com · Corpo e resposta em JSON · Chave com nível write (ver Autenticação).

POST /api/v1/convert-links

curl -X POST https://mcpdoafiliado.com/api/v1/convert-links \
  -H "X-API-Key: SUA_API_KEY" -H "content-type: application/json" \
  -d '{"urls":["https://shopee.com.br/product/1/2","https://www.amazon.com.br/dp/B0XXXX"]}'

Com url (singular) a resposta é do item só; com urls vem items[], cada um com ok, affiliate_url, final_url, site, provider e tracking_id. Até 150 por chamada.

POST /api/v1/product

curl -X POST https://mcpdoafiliado.com/api/v1/product \
  -H "X-API-Key: SUA_API_KEY" -H "content-type: application/json" \
  -d '{"url":"https://shopee.com.br/product/1/2","history_limit":10}'

Devolve product (título, preço, price_number, imagem, disponibilidade…), os links e price_history.

POST /api/v1/search-products

curl -X POST https://mcpdoafiliado.com/api/v1/search-products \
  -H "X-API-Key: SUA_API_KEY" -H "content-type: application/json" \
  -d '{"query":"air fryer","price_max":400,"sort":"sales_desc","limit":20}'

Mesmos filtros da ferramenta search_products. A resposta traz items[], count, page e, quando houver, sites_failed.

GET /api/v1/bot

curl https://mcpdoafiliado.com/api/v1/bot -H "X-API-Key: SUA_API_KEY"

Marketplaces ativos para busca, catálogos públicos e o resumo das rotas convertíveis por provedor.

Códigos