shopee-afflib 1.0.10

Biblioteca para integração com a API de Afiliados da Shopee (síncrona e assíncrona).

🛒 Shopee AffLib

Biblioteca Python para integração com a API de Afiliados da Shopee — suporta chamadas síncronas e assíncronas, geração de links, e download de imagens.

🚀 Instalação

pip install shopee-afflib

🧩 Uso sincrono básico

# Sincrono
from shopee_affiliate import client
url = "https://shopee.com.br/..."  # SUA URL DA SHOPEE 
cliente = client.create_sync_client(partner_id='SEU_APP_ID', partner_key='SUA_CHAVE_SECRETA')
result = cliente.get_product_offer(url=url)
print(result)
# 💽 Se quiser salvar a imagem do produto em memória ou localmente:
cliente.download_product_image(result)
# Para obter o link curto de afiliado de algum produto
link_curto = cliente.get_short_url(url)
print(link_curto)

🧩 Uso assíncrono básico com aiohttp

# Assíncrono
from shopee_affiliate import client
import asyncio
async def main():
    url = "https://shopee.com.br/..." # SUA URL DA SHOPEE 
    cliente = client.create_async_client(partner_id='SEU_APP_ID', partner_key='SUA_CHAVE_SECRETA')
    result = await cliente.get_product_offer(url=url)
    print(result)
    # 💽 Se quiser salvar a imagem do produto em memória ou localmente:
    cliente.download_product_image(result)

    # Para obter o link curto de afiliado de algum produto
    link_curto = cliente.get_short_url(url)
    print(link_curto)

asyncio.run(main())

🧩 Exibindo a imagem do produto com PIL

pip install pillow shopee-afflib

from shopee_affiliate import client
from PIL import Image

# Configurações
PARTNER_ID = 'SEU_APP_ID'
PARTNER_KEY = 'SUA_CHAVE_SECRETA' 

cliente = client.create_sync_client(PARTNER_ID, PARTNER_KEY)
url = "https://shopee.com.br/..."
response = cliente.get_product_offer(url=url)

#baixa a imagem do produto e guarda em  memória pronta para uso
image = cliente.download_product_image(product_data=response, to_memory=True)

# Cria um objeto Image a partir da imagem em memória
new_image = Image.open(image)
# Exibe a imagem
new_image.show()

⚙️ Recursos principais

• 🔗 Busca de produtos individuais via shop_id e item_id ou url
• 🔗 Busca de produtos de uma loja via shop_id ou link, e o prametro by_shop (defina um limite de itens com limit)
• 🔗 Busca de produtos aleatórios (sem parametro)
• 🌐 Consulta direta de produtos de uma loja por URL de produto
• 🌐 Obter link curto de afiliado do produto
• 💾 Download de imagens (em arquivo ou memória)
• 🧠 Versões síncrona e assíncrona

🔥 Novidades

v 1.0.10

• Adicionado mais argumentos para busca de seletiva de itens
• Vaárias melhorias no código.

v.1.0.5

• Adiconado a possibidade de pesquisar produtos de uma loja pela URL
• Pequenas correções de bugs

v.1.0.0

• Versão inicial

sortType

🔹 Valores disponíveis Valor Constante Significado 1 SHOP_LIST_SORT_TYPE_LATEST_DESC Ordena pelo último update dos produtos/lojas (mais recentes primeiro). 2 SHOP_LIST_SORT_TYPE_HIGHEST_COMMISSION_DESC Ordena pela maior comissão (do mais alto para o mais baixo). 3 SHOP_LIST_SORT_TYPE_POPULAR_SHOP_DESC Ordena pela popularidade da loja (mais popular primeiro).

✨ Créditos

Desenvolvido por Anthony Santos