AGagentkey
ecommerce/amazon

Search product listings on Amazon by keyword. Returns a normalized Product page.

Keyword search over product listings on Amazon. Results are normalized to the Product object; page with next_cursor. The server picks the provider and fails over; the response names the provider that served it.

Fixed price: 4.4 credits per successful call, whichever provider serves it.

post/v2/ops/ecommerce.amazon.product.search

Request

  • Base URL
    https://api.agentkey.app
  • URL
    https://api.agentkey.app/v2/ops/ecommerce.amazon.product.search
  • Auth
    HTTP bearer

Request body

condition'all' | 'new' | 'used' | 'renewed' | 'collectible'

Product condition filter.

country'US' | 'AU' | 'BR' | 'CA' | 'CN' | 'FR' | 'DE' | 'IN' | 'IT' | 'MX' | 'NL' | 'SG' | 'ES' | 'TR' | 'AE' | 'GB' | 'JP' | 'SA' | 'PL' | 'SE' | 'BE' | 'EG' | 'ZA' | 'IE'

Amazon marketplace, ISO 3166-1 alpha-2 (US = amazon.com, GB = amazon.co.uk, DE = amazon.de …).

cursorstring

Opaque pagination cursor from the previous response's next_cursor. Send the same query parameters with it.

deals'none' | 'all_discounts' | 'todays_deals'

Restrict to discounted listings (all_discounts) or Today's Deals (todays_deals).

fieldsstring[]

Projection: keep only these dotted paths of data, e.g. ["items.id", "items.text"].

include_rawboolean

Attach the raw upstream payload as raw (not a stable contract; truncated above 256 KB).

limitinteger

Maximum number of products to return.

price_maxnumber

Highest selling price to include, in the platform's currency.

price_minnumber

Lowest selling price to include, in the platform's currency.

prime_onlyboolean

Only Prime-eligible listings.

providerstring

Shorthand for routing.only = [provider].

querystring required

Keyword or phrase to search for.

sort'general' | 'latest' | 'sales' | 'price_asc' | 'price_desc'

general = the platform's default ranking; sales = best selling first; price_asc / price_desc = by selling price.

Response

Success envelope

credits_chargednumber required

Credits charged for this call (the method's fixed price).

opstring required

Method name.

op_versioninteger required

Method version that served the call.

providerstring required

Provider that actually served the call.

rawunknown
raw_truncatedboolean
request_idstring required

Correlation id; quote it in support requests.

took_msinteger required
unsupported_fieldsstring[] required

Output paths this provider structurally does not supply; such fields are null for a different reason than 'missing on this record'.

Changes

No recorded changes to this operation across all 1 revision of this API.