Marketplace10 marketplaces

Amazon

2 endpoints: search and product details. Each runs as an extraction Job from your agent, one URL per Job. Every account starts with 200 free trial credits.

Search

Search an Amazon marketplace using /s?k=keyword, starting at page one. No search filters.

ID: amazon.search_items
Version: 1
Typical time: About 60 s (estimate)

Inputs

One url per Job, plus these bounded parameters. Unknown parameters are rejected.

Parameter	Type	Allowed	Default
`max_pages`	integer	1–25	1

Example submit_job input

{
  "blueprint_id": "amazon.search_items",
  "blueprint_version": "1",
  "url": "https://www.amazon.com/s?k=coffee",
  "parameters": {
    "max_pages": 1
  }
}

Returned fields

Every record follows this schema. Optional fields are null when the source doesn't show them.

Field	Type	Notes
`asin`	string required	Pattern ^[A-Z0-9]{10}$
`title`	string required	—
`url`	string (uri) required	—
`price`	string or null required	—
`old_price`	string or null required	—
`rating`	string or null required	—
`reviews`	integer or null required	Minimum 0
`page`	integer required	Minimum 1
`position`	integer required	Minimum 1

Product details

Fetch one Amazon product using /dp/ASIN or /gp/product/ASIN. Use URLs from search results.

ID: amazon.product_details
Version: 1
Typical time: About 30 s (estimate)

Inputs

One url per Job. Unknown parameters are rejected.

Example submit_job input

{
  "blueprint_id": "amazon.product_details",
  "blueprint_version": "1",
  "url": "https://www.amazon.com/dp/B0EXAMPLE0",
  "parameters": {}
}

Returned fields

Every record follows this schema. Optional fields are null when the source doesn't show them.

Field	Type	Notes
`asin`	string required	Pattern ^[A-Z0-9]{10}$
`title`	string required	—
`url`	string (uri) required	—
`price`	string required	—
`country`	string required	—
`fetch_status`	"ok" required	—
`scraped_at`	string (date-time) required	—