One API, 2 marketplaces

Americanas and Magazine Luiza data from one API

Brazilian price comparison runs through both of these, and the same SKU frequently carries different prices and different sellers on each. One key covers both, with the seller and shipping surfaces that decide which offer is actually cheaper.

Why not the official API

Both run seller-facing APIs: they return YOUR catalogue once you are an approved merchant, not the marketplace's. For reading public prices across either, they do not apply.

Coverage

What the two engines give you

Americanas
search, category, product/detail, product/batch, seller/products, filters
Magazine Luiza
search, category, product/detail, product/reviews, product/shipping
Batch
Americanas takes a batch of products in one call
Shipping
Magalu exposes shipping as its own endpoint
Worked example

Price one product across both

Search each side, then read the detail; the delivered price needs Magalu's shipping call.

  1. 1
    POST /americanas/v1/search

    find the product, take its id

  2. 2
    POST /americanas/v1/product/detail

    price and the seller behind the offer

  3. 3
    POST /magalu/v1/search

    the same product on Magalu

  4. 4
    POST /magalu/v1/product/shipping

    delivered cost, which often flips the ranking

Two sticker prices and one delivered price, for the same product, in four calls.

Before you join them

Where the two sources genuinely differ

 americanasmagalu
Reviewsnot exposed as its own endpointproduct/reviews
Shippingnot exposed separatelyproduct/shipping
Bulkproduct/batch for many ids at onceno batch endpoint
Sellersseller/products lists a seller's catalogueno seller endpoint