Tridge APItridge.com ↗

"""Walkthrough: Tridge agri-food trade data — search, trade, prices, suppliers, offers, and insights."""
from parse_apis.tridge_com_api import Tridge, InputNotFound, InsightContentType

client = Tridge()

# Search for agri-food products by keyword; limit= caps total items fetched.
product = client.products.search(query="mango", limit=1).first()
if product is None:
    print("no products found")
    raise SystemExit

print(product.name, product.product_code, product.thumbnail_url)

# Drill into the global trade overview for this product.
overview = product.trade_overview()
print(overview.product_name, "HS:", overview.hs_code)
print("Updated:", overview.updated_at)

# Show top exporting countries (if export data exists).
if overview.exports is not None:
    print(f"Export base year: {overview.exports.base_year}")
    for tc in overview.exports.top_countries[:3]:
        print(f"  #{tc.rank} {tc.country_code}  ${tc.value_usd:,.0f}  {tc.volume_kg:,.0f} kg")

# Pick the first available country code and fetch its country-level trade profile.
if overview.country_codes:
    country_code = overview.country_codes[0]
    try:
        country = overview.country_overview(country_code=country_code)
    except InputNotFound:
        print(f"no country overview for {country_code}")
        raise SystemExit

    print(f"\n{country.product_name} in {country.country_code}")

    if country.exports is not None:
        for yr in country.exports.annual[:3]:
            print(f"  {yr.year}: ${yr.value_usd:,.0f}  {yr.volume_kg:,.0f} kg")

    if country.export_transactions is not None:
        print(f"  Sample rate: {country.export_transactions.sample_rate:.4f}")
        for tx in country.export_transactions.sampled_transactions[:3]:
            print(f"    {tx.date} {tx.export_country_code}->{tx.import_country_code} ${tx.unit_price_usd_per_kg:.2f}/kg")

# Global price overview for this product.
prices = product.price_overview()
print(f"\nPrices for {prices.product_name}, updated {prices.updated_at}")
if prices.wholesale is not None and prices.wholesale.top_countries:
    top = prices.wholesale.top_countries[0]
    print(f"  Top wholesale country: {top.country_code} avg ${top.unit_price_avg_usd_per_kg:.2f}/kg")

# Supplier sell offers for this product.
offer = product.offers.list(limit=1).first()
if offer is not None:
    print(f"\nOffer: {offer.name} from {offer.origin_country_code}")
    if offer.supplier is not None:
        print(f"  Supplier: {offer.supplier.name} ({offer.supplier.country_code})")

# Supplier companies for this product.
supplier = product.suppliers.list(limit=1).first()
if supplier is not None:
    print(f"\nSupplier: {supplier.name} in {supplier.country_code}")

# Market insights (articles) about the product.
insight = client.insights.list(
    content_type=InsightContentType.ARTICLE,
    insight_product_code="mango",
    limit=1,
).first()
if insight is not None:
    print(f"\nInsight: {insight.title} ({insight.date})")
    print(f"  {insight.summary[:120]}...")

print("\nexercised: products.search / trade_overview / country_overview / price_overview / offers.list / suppliers.list / insights.list")