Add a Single Amazon ASIN

GuideUpdated 2026-06-20

An ASIN (Amazon Standard Identification Number) is the 10-character product identifier used across all Amazon marketplaces. Adding one to a collection tells MultiCartAPI to scrape that product's pricing, availability, and details on every scheduled or manual run.

Before you start

You need:

An existing collection — create one first if you haven't already.
An active postcode for the domain you want to scrape — add one here. The postcode dropdown in the drawer only shows postcodes that match the selected domain.

In the dashboard

Open Collections from the sidebar, then click the collection you want to add the ASIN to.
You land on the collection's records page. The header shows the collection name and current record count.

Collection records page header showing collection name badge, record count, and Add single / Add bulk buttons — The records page header. Use Add single for one ASIN or Add bulk for a CSV import.

Click Add single (top-right of the page header). A drawer slides in from the right titled Add single record.
Fill in the fields:
- Amazon Domain — choose the marketplace (e.g. amazon.com.au). Changing the domain clears the postcode selection.
- ASIN — the 10-character product identifier, e.g. B0DJQQ38TG.
- Customer Postcode/Zipcode — only postcodes that match the selected domain are shown. If the dropdown is empty, add a postcode for that domain first.
- Output — currently JSON is the only available format.
- Include Raw HTML — set to True to receive the raw page HTML alongside the parsed data. Defaults to False.

Add single record drawer open showing Domain, ASIN, Customer Postcode, Output, and Include Raw HTML fields — Each field in the Add single record drawer. Fill them top to bottom.

Drawer with amazon.com.au selected and the postcode dropdown populated with only postcodes for that domain — The postcode dropdown filters to the selected domain automatically — only postcodes you have already set up for that marketplace appear.

Click Save. A toast confirms "Single ASIN added successfully" and the drawer closes. The new record appears in the table immediately.

Collection auto-enables on first ASIN

Adding the first ASIN to a collection that is still in draft status automatically promotes it to Enabled, so you do not need to manually flip the toggle.

No duplicate ASINs per domain and postcode

The same ASIN, domain, and postcode combination can only be added once per collection. Submitting a duplicate returns a validation error.

Via the API

Create ASIN

POST

https://multicartapi.com/api/v1/schedules/amazon/asin/create/

API Key or Session Token

Parameter	In	Type	Required	Default	Description
`collection`	body	integer	Required	—	ID of the collection to add this ASIN to.
`domain`	body	integer	Required	—	Domain ID from POST /settings/domains/ (e.g. 1 for amazon.com.au).
`customer_postcode`	body	integer	Required	—	Zipcode row ID from /zipcodes/get-zipcodes/. Must be an active postcode for the chosen domain.
`asin`	body	string	Required	—	10-character Amazon product identifier, e.g. B0DJQQ38TG.
`custom_id`	body	string	Optional	—	Optional reference ID stored alongside the ASIN — useful for mapping results back to your own catalog.
`include_raw_html`	body	boolean	Optional	true	Set to false to omit raw HTML from the scrape output and reduce response size.
`output`	body	string	Optional	JSON	Output format: JSON or HTML.

Pass IDs, not strings

domain and customer_postcode must be integer IDs, not domain name strings or postcode strings. Retrieve them from GET /settings/domains/ and GET /zipcodes/get-zipcodes/ respectively.

curl https://multicartapi.com/api/v1/schedules/amazon/asin/create/ \
  -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "collection": 101,
    "domain": 1,
    "customer_postcode": 15,
    "asin": "B0DJQQ38TG",
    "custom_id": "ref-001",
    "include_raw_html": false,
    "output": "JSON"
  }'

Response

{
"code": 200,
"data": {
  "id": 5,
  "asin": "B0DJQQ38TG",
  "collection": 101,
  "domain": 1,
  "customer_postcode": 15,
  "custom_id": "ref-001",
  "include_raw_html": false,
  "output": "JSON",
  "created_at": "2026-06-20T10:00:00Z"
},
"status": 1
}

The id returned in data is the ASIN row ID — keep it if you need to update or delete this record later.

Next steps

Add ASINs in Bulk Import up to 5,000 ASINs at once from a CSV file.Create a Collection Set up the collection schedule and settings before adding records.Add a Postcode / ZIP Create an active delivery postcode for each domain you scrape.