52wmb API52wmb.com ↗

"""Walkthrough: 52wmb Trade Company SDK — search suppliers, drill into a profile."""
from parse_apis.api_52wmb_com_api import (
    TradeCompany, SearchType, CompanyType, Sort, CompanyNotFound,
)

client = TradeCompany()

# Search for coffee buyers, sorted by shipment count.
for summary in client.company_summaries.search(
    query="coffee",
    search_type=SearchType.PRODUCT,
    company_type=CompanyType.BUYER,
    sort=Sort.BILL_COUNT,
    limit=5,
):
    print(summary.name, summary.country, summary.trade_count)

# Drill down: take the first result and fetch its full profile.
hit = client.company_summaries.search(
    query="nestle", search_type=SearchType.COMPANY_NAME, limit=1,
).first()

if hit is not None:
    # Navigate from summary to full detail via typed instance method.
    company = hit.details()
    print(company.name, company.country_en, company.trade_count)

    # Inspect top products and HS codes.
    for prod in company.top_products:
        print(f"  product: {prod.product}  share: {prod.share_percent}%")
    for hs in company.top_hs_codes:
        print(f"  hs_code: {hs.hs_code}  shipments: {hs.trade_count}")

    # Monthly trade trend.
    trend = company.monthly_trends
    print(f"trend period: {trend.start_month} to {trend.end_month}")
    for m in trend.months[:3]:
        print(f"  {m.month}: {m.trade_count} shipments, weight={m.weight}")

# Point lookup by known id (using values discovered from the search above).
if hit is not None:
    try:
        detail = client.companies.get(
            company_id=hit.company_id, company_type=hit.company_type,
        )
        print(detail.name, detail.star_rating, detail.activity_score)
    except CompanyNotFound:
        print("company no longer available")

print("exercised: company_summaries.search / details / companies.get")