Connect Your Business to a Wider Product Catalog and More Opportunities

The MediaMax B2B API lets you connect an online shop, ERP or internal system to our catalogue, prices, stock, orders and shipments using authenticated HTTP requests.

The catalogue lets you retrieve a paginated list and then query the up-to-date details of a SKU. Depending on the product, the data may include name, reference, customer price, availability, EAN, images and energy information.

Retrieve catalogue

                curl --request GET \
  --url 'https://www.mediamax.es/api/product/all?pag=1&max=25' \
  --header 'HTTP-API-KEY: YOUR_TOKEN' \
  --header 'Accept-Language: en'
              

Query a product

                curl --request GET \
  --url 'https://www.mediamax.es/api/product/SAMPLE-SKU' \
  --header 'HTTP-API-KEY: YOUR_TOKEN'
              

Simplified illustrative response

                {
  "id": 12345,
  "attributes": {
    "name": "Sample product",
    "sku": "SAMPLE-SKU",
    "price": 199.99,
    "qty_available": 8,
    "gallery": []
  }
}
              

Feeds provide files to be imported periodically into an eCommerce platform, ERP or integrator. They are an alternative or complement to the API: they allow batch synchronisation without making individual queries per product.

Fast price and availability feed

Recommended update frequency: every 15–30 minutes, depending on the integration process.

Documented format: field separator |; text delimiter '.

The Exclusive Extended Catalog includes items not yet published on our website, giving you access to a much wider catalogue.

What advantages does it offer?

Its purpose is to improve matching with existing listings on platforms such as Amazon, Miravia and other marketplaces, increasing the chances of selling our products.

What advantages does it offer?

Each API integration is associated with a MediaMax user and email linked to the customer's commercial and tax configuration. That association affects the price list, prices and invoicing treatment.

An API order brings together the customer's own reference, the billing address, the shipping address and the lines with SKU and quantity. MediaMax returns an identifier that must be kept alongside the original reference.

Create order

                curl --request POST \
  --url 'https://www.mediamax.es/api/order' \
  --header 'HTTP-API-KEY: YOUR_TOKEN' \
  --header 'Content-Type: application/json' \
  --data @pedido.json
              

Example pedido.json

                {
  "b2b_reference": "CUSTOMER-ORDER-2026-0001",
  "order_billing_address": {
    "name": "Laura",
    "lastname": "García",
    "company": "Example Company SL",
    "email": "compras@example.com",
    "phone": "+34900000000",
    "street": "1 Example Street",
    "postcode": "03001",
    "city": "Alicante",
    "region_id": "A",
    "country": "ES"
  },
  "order_shipping_address": {
    "name": "Laura",
    "lastname": "García",
    "company": "Example Company SL",
    "email": "logistica@example.com",
    "phone": "+34900000000",
    "street": "Delivery Avenue 10",
    "postcode": "03002",
    "city": "Alicante",
    "region_id": "A",
    "country": "ES",
    "express": 0
  },
  "order_lines": [
    {"sku": "SAMPLE-SKU", "quantity": 1}
  ]
}
              

Query several references

                curl --request GET \
  --url 'https://www.mediamax.es/api/batch/reference?pag=1&max=25&references=ORDER-001&references=ORDER-002' \
  --header 'HTTP-API-KEY: YOUR_TOKEN'
              

In Dropship, MediaMax prepares and ships orders on behalf of the customer, using the account configuration for documentation and labelling. According to the procedure described, orders placed via the API use this method.

An order may generate one or several shipments. Each one may have its own picking reference, carrier, tracking number and logistics status.

Query shipment by reference

                curl --request GET \
  --url 'https://www.mediamax.es/api/packing/show/reference/WH%2FOUT%2F00000' \
  --header 'HTTP-API-KEY: YOUR_TOKEN'
              

Simplified illustrative response

                {
  "code": "200",
  "status": "success",
  "data": {
    "id": 4567,
    "attributes": {
      "reference": "WH/OUT/00000",
      "tracking": "TRACKING-SAMPLE",
      "status": "done"
    }
  }
}
              

Query all shipments of the order

                curl --request GET \
  --url 'https://www.mediamax.es/api/packing/show/order/odoo/S00000' \
  --header 'HTTP-API-KEY: YOUR_TOKEN'
              

Moving from DEMO to production requires supervising the first operations to confirm that the integration works with real data. A contact hold is used to control the transfer of the picking until the review is complete.

Summary of operations