{"name":"Austral","description":"Machine-first retail price discovery API. Finds a canonical product across multiple merchants, returns their current offers cheapest-first, and hands back a purchase URL for the one you pick.","api_version":"v1","authentication":"None. All endpoints are public and read-only.","coverage":{"country":"BR","currency":"BRL","merchants":["KaBuM!","TerabyteShop","Pichau"],"categories":"Primarily PC hardware, gaming and consumer electronics."},"workflow":[{"step":1,"action":"Search using the shopper's own words.","request":"GET /v1/search?q=galaxy%20s25%20ultra%20512gb","returns":"results[]: canonical products, best match first, each with _links.offers."},{"step":2,"action":"Pick the canonical product that matches what the shopper meant.","request":"GET /v1/products/{product_id}","returns":"The product, its brand and identifiers, and links to offers and price history."},{"step":3,"action":"Get current offers. This is the price comparison.","request":"GET /v1/products/{product_id}/offers","returns":"offers[]: one per merchant, sorted price ascending. Each has price, shipping, availability, observed_at, freshness and purchase_url."},{"step":4,"action":"Send the shopper to buy, using purchase_url verbatim.","request":"The purchase_url from the chosen offer.","returns":"A redirect to the merchant's own product page."},{"step":5,"action":"Optional: check whether the current price is actually a good one.","request":"GET /v1/products/{product_id}/prices","returns":"Observed price history for the product."}],"rules":["Do not invent or guess Austral product IDs or listing IDs. Only use IDs returned by a previous response.","Do not construct merchant URLs yourself. Use purchase_url exactly as given; it is the only link that records the referral correctly.","Prices are observations, not live quotes. Check observed_at, age_seconds and freshness before calling a price current.","Do not assume shipping is free when shipping is null. Null means unknown, not zero.","An empty offers list means no merchant currently has it in stock, not that the product does not exist.","Follow the _links in each response instead of building URLs from templates by hand."],"price_kinds":["pix: paid instantly via PIX, usually the cheapest in Brazil.","cash: paid up front by bank slip or similar.","card: credit card, typically the list price.","advertised: the merchant's reference price when no payment-specific price is exposed."],"_links":{"self":{"href":"https://api.austral.market/"},"api":{"href":"https://api.austral.market/v1","description":"Version-scoped discovery document."},"search":{"href":"https://api.austral.market/v1/search{?q}","description":"Start here when you have a human product name.","templated":true},"openapi":{"href":"https://api.austral.market/openapi.json","description":"Complete machine-readable contract."},"api_catalog":{"href":"https://api.austral.market/.well-known/api-catalog"},"llms":{"href":"https://api.austral.market/llms.txt","description":"The same guidance as plain text."},"health":{"href":"https://api.austral.market/health"}}}