Domains & Suppliers

A Domain represents a marketplace or data supplier. Every item you add to a Collection — every ASIN or SKU — is tied to a domain ID, so fetching the domain list is typically the first call you make.

Supplier types

The supplier_type field on each domain tells you how MultiCartAPI retrieves data for it.

scraping

Data is collected by a browser-based scraper. Used for all Amazon marketplaces. Requires a postcode and cookie file per domain.

rest_api

Data is pulled from the supplier's own API or catalogue service. Used for Officeworks. No cookie required.

csv_import

Reserved for suppliers whose data is ingested via a periodic CSV feed. Not currently exposed as a public marketplace.

Listing domains

POST /settings/domains/ returns every active domain on the platform. This endpoint requires no authentication — it is safe to call before you have a session.

No request body is needed.

curl https://multicartapi.com/api/v1/settings/domains/ \
  -X POST

{
  "code": 200,
  "status": 1,
  "data": [
    {
      "id": 1,
      "domain": "amazon.com.au",
      "domain_url": "https://www.amazon.com.au",
      "country_code": "AU",
      "supplier_type": "scraping",
      "status": "active"
    },
    {
      "id": 2,
      "domain": "amazon.com",
      "domain_url": "https://www.amazon.com",
      "country_code": "US",
      "supplier_type": "scraping",
      "status": "active"
    },
    {
      "id": 3,
      "domain": "amazon.co.uk",
      "domain_url": "https://www.amazon.co.uk",
      "country_code": "GB",
      "supplier_type": "scraping",
      "status": "active"
    },
    {
      "id": 24,
      "domain": "officeworks.com.au",
      "domain_url": "https://www.officeworks.com.au",
      "country_code": "AU",
      "supplier_type": "rest_api",
      "status": "active"
    }
  ]
}

Supported Amazon marketplaces

MultiCartAPI supports the following Amazon domains. All have supplier_type: "scraping".

In addition, officeworks.com.au (id 24) is supported as the Officeworks (rest_api) domain — see The Officeworks domain section below.

The Officeworks domain

Officeworks is the single rest_api domain on the platform.

Unlike Amazon domains, Officeworks does not require cookie generation. When you create a postcode for officeworks.com.au, it becomes active immediately.

Using domain IDs in other calls

Once you have the id for a domain, you use it in several places: