Mercado de Cavalos APImercadodecavalos.com.br ↗

"""Walkthrough: Mercado de Cavalos SDK — browse Brazil's horse marketplace."""
from parse_apis.mercado_de_cavalos_api import MercadoDeCavalos, Sort, ListingNotFound

client = MercadoDeCavalos()

# Search for horses sorted by newest, capped at 5 results
for horse in client.horsesummaries.search(sort_order=Sort.NEWEST, limit=5):
    print(horse.name, horse.price, horse.breed)

# Drill into the first result for full details and seller contact
listing = client.horsesummaries.search(sort_order=Sort.NEWEST, limit=1).first()
if listing:
    detail = listing.details()
    print(detail.name, detail.price, detail.location, detail.seller)
    print("Photos:", len(detail.photos))
    print("Pedigree paternal:", detail.pedigree.paterna)

    # Get seller contact info
    contact = listing.contact()
    print("Contacts:", contact.contacts)

# Browse stallions available for breeding
for stallion in client.stallions.list(limit=3):
    print(stallion.name, stallion.breed, stallion.price)

# Read news articles and drill into full content
article_summary = client.articlesummaries.list(limit=1).first()
if article_summary:
    full = article_summary.full_article()
    print(full.title, full.content[:100])

# Typed error handling for a missing listing
try:
    bad = client.contacts.get(ref_id="99999999")
    print(bad.ref_id, bad.contacts)
except ListingNotFound as exc:
    print(f"Listing not found: {exc.ref_id}")

print("exercised: horsesummaries.search / details / contact / stallions.list / articlesummaries.list / full_article / contacts.get")