logo

Run a Request in the Playground

GuideUpdated 2026-06-20

The Playground lets you fire a single live scrape straight from the dashboard — no collection, no scheduler, just a result in seconds. It is the fastest way to check that a domain, postcode, and ASIN or SKU all resolve correctly before you build a full pipeline.

In the dashboard

Welcome screen

Open Playground from the sidebar. The welcome screen lets you choose between Amazon and Officeworks, and shows the code-sample panel on the right with your live API key already filled in.

Playground welcome screen with Amazon and Officeworks tabs and a code-sample panel on the right
Choose your supplier on the welcome screen. The code-sample panel on the right stays in sync as you fill in the form.

Amazon form

Select the Amazon tab and fill in:

  1. Domain — pick the marketplace you want to scrape (e.g. amazon.com.au).
  2. ASIN — the 10-character Amazon product identifier, e.g. B0DJQQ38TG.
  3. Postcode — choose one of your active postcodes for that domain. If none appear, add a postcode first.
  4. FormatJSON returns structured product data; HTML returns the raw page HTML.
  5. Include raw HTML — toggle on if you want the raw HTML bundled alongside the parsed JSON output.
Playground Amazon form with domain, ASIN, postcode, format and raw HTML fields filled in
Every field maps directly to an API parameter — the code-sample panel updates live as you type.

Code-sample panel

The panel on the right of the form shows a ready-to-run request in curl, Python, and Node with your actual API key substituted in. You can copy any snippet and run it from your own environment.

Code-sample panel showing curl, Python and Node tabs with a live API key and the filled-in form values
Copy any tab directly — your live key is already there.

Send and view results

Click Send. The Results pane appears below (or to the right, depending on your screen width) and shows the parsed JSON output as soon as the scrape completes.

Playground results pane showing a parsed JSON product record with title, price and availability fields
Results appear synchronously — refresh is not needed.

Officeworks form

Switch to the Officeworks tab. The form changes to:

  1. SKU — the Officeworks product code, e.g. JBMS310BK.
  2. Store — the Officeworks store ID, e.g. W411. Use List Officeworks Stores to find valid IDs.
  3. Postcode — a 4-digit Australian postcode, e.g. 4500.
Playground Officeworks form with SKU, store and postcode fields filled in
Officeworks scrapes use the store and postcode to determine local stock and pricing.

Click Send — the result appears in the same Results pane.

Each Playground request costs 1 credit

Clicking Send triggers a real scrape and deducts 1 credit from your balance. If your balance is too low, the request will still return HTTP 200 and status: 1, but data.output.error will contain "Insufficient Credits". See Understanding API Errors for how to handle that case.


Via the API

Amazon: test-scrape an ASIN

Test-scrape an Amazon ASIN

POST
https://multicartapi.com/api/v1/playground/post/
API Key or Session Token
ParameterTypeRequiredDescription
domainstringRequiredDomain ID as a string, e.g. "1". Get the numeric ID from POST /settings/domains/ and encode it as a string.
customer_postcodestringRequiredZipcode row ID as a string, e.g. "14". Get the row ID from POST /zipcodes/get-zipcodes/ and encode it as a string.
asinstringRequiredAmazon ASIN to scrape, e.g. "B0DJQQ38TG".
outputstringRequiredOutput format: "JSON" or "HTML".
include_raw_htmlstringOptionalWhether to include raw HTML in the output. Must be the string "true" or "false" — not a boolean.
curl https://multicartapi.com/api/v1/playground/post/ \
  -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "1",
    "customer_postcode": "14",
    "asin": "B0DJQQ38TG",
    "output": "JSON",
    "include_raw_html": "false"
  }'
Response
{
"code": 200,
"data": {
  "type": "json",
  "output": {
    "asin": "B0DJQQ38TG",
    "title": "Example Product Title",
    "price": "$49.99",
    "availability": "In Stock"
  }
},
"status": 1
}

Two things to watch out for with this endpoint:

  • domain and customer_postcode are string-encoded integer IDs, not domain names or postcode numbers. Pass "1", not "amazon.com.au".
  • include_raw_html is a string ("true" or "false"), not a JSON boolean. The backend does not coerce the type.
  • On insufficient credits the envelope still returns status: 1. Check data.output.error — if it contains "Insufficient Credits", top up before retrying.

Officeworks: test-scrape a SKU

Test-scrape an Officeworks SKU

POST
https://multicartapi.com/api/v1/playground/officeworks/post/
API Key or Session Token
ParameterTypeRequiredDescription
skustringRequiredOfficeworks SKU code, e.g. "JBMS310BK". The field is sku — not asin.
store_idstringRequiredOfficeworks store ID, e.g. "W411". Get valid IDs from POST /settings/officeworks/stores/.
customer_postcodestringRequiredPostcode number as a string, e.g. "4500".
curl https://multicartapi.com/api/v1/playground/officeworks/post/ \
  -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sku": "JBMS310BK",
    "store_id": "W411",
    "customer_postcode": "4500"
  }'
Response
{
"code": 200,
"data": {
  "type": "json",
  "output": {
    "sku": "JBMS310BK",
    "title": "JBL Flip 6 Portable Bluetooth Speaker",
    "price": "$149.00",
    "availability": "In Stock"
  }
},
"status": 1
}

The field name is sku, not asin. Do not pass a domain field — the backend does not require it for Officeworks playground requests.