The ASIN Data API connector lets your AI agent act in each user's ASIN Data API account. Each user connects their own ASIN Data API API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 25 tools.
- Tools
- 25
- What they doRead · write · destructive
- 13 · 8 · 413 read8 write4 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the ASIN Data API connection
In AgentKit > Connections, create an ASIN Data API connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'asindata'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize ASIN Data API:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'asindata_account_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "asindata"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize ASIN Data API:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="asindata_account_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their ASIN Data API credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolasindata_account_getGet your ASIN Data API account usage and the platform status.Read-onlyGet Account Usage
Get your ASIN Data API account usage and the platform status. Free; uses no credits. Returns account_info (plan, credits used and remaining this month, overage) and current platform status. Use this to check credits before large jobs or to test the connection.
Inputs
This tool takes no inputs.
asindata_category_getList the products in an Amazon category (browse node), by category ID or category page URL.Read-onlyGet Amazon Category Results
List the products in an Amazon category (browse node), by category ID or category page URL. Returns category_results with each product's ASIN, title, price, rating and position, plus refinements and pagination. Use this to browse a category. Use asindata_search for keyword searches.
Inputs
amazon_domainstring- Amazon site to query, for example amazon.com, amazon.co.uk, amazon.de, amazon.co.jp. See the supported domains list in the ASIN Data API docs. Example: amazon.com.
category_idstring- Amazon category (node) ID, used with amazon_domain. Send category_id or url. Example: 172282.
exclude_fieldsstring- Comma-separated JSON fields to drop from the response, in dot notation. Example: product.images,product.videos.
include_fieldsstring- Comma-separated JSON fields to keep in the response, in dot notation, to shrink it. Example: product.title,product.buybox_winner.price.
include_htmlboolean- Include the raw Amazon HTML in the response (much larger). Example: false.
max_pageinteger- Fetch pages from page through max_page in one call and join them. Each page costs a request credit. Example: 3.
pageinteger- Page of results to return. Check pagination.total_pages in the response. Example: 1.
refinementsstring- Comma-separated refinement values (from the refinements in a previous response) to filter by rating, price, brand and so on. Example: p_72/1248879011,p_89/Apple.
skip_on_incidentstring- Refuse to serve (and charge for) the request during a live parsing incident: all (degraded or major) or major_only. Example: major_only.one of
allmajor_only sort_bystring- Sort order. Example: featured.one of
most_recentprice_low_to_highprice_high_to_lowfeaturedaverage_review urlstring- Amazon category page URL to read instead of category_id. Example: https://www.amazon.com/s?node=172282.
asindata_collection_getGet one Collection's settings and state.Read-onlyGet Collection
Get one Collection's settings and state. Returns id, name, schedule, priority, destinations, enabled, status (idle, queued, running), request counts, requests_page_count, credits_required and results_count. Use this to check whether a collection is running before changing it.
Inputs
collection_idstringrequired- Collection ID. Get it from asindata_collections_list or the create response. Example: F994420D.
asindata_collection_requests_download_links_getGet download links for all requests in a Collection as a JSON or CSV file.Read-onlyGet Request Download Links
Get download links for all requests in a Collection as a JSON or CSV file. Returns links to the file(s) containing every request. Use this for large collections instead of paging asindata_collection_requests_list.
Inputs
collection_idstringrequired- Collection ID. Get it from asindata_collections_list or the create response. Example: F994420D.
formatstringrequired- File format: json or csv. Example: json.one of
jsoncsv
asindata_collection_requests_listList one page (1000 per page) of the requests in a Collection, or search them by text or custom_id.Read-onlyList Collection Requests
List one page (1000 per page) of the requests in a Collection, or search them by text or custom_id. Returns requests with id, custom_id and parameters, plus the current page and page count. Use this to find a request_id to update or delete.
Inputs
collection_idstringrequired- Collection ID. Get it from asindata_collections_list or the create response. Example: F994420D.
pageintegerrequired- Page of requests, starting at 1. Get the count from requests_page_count on asindata_collection_get. Example: 1.
qstring- Only requests whose parameters or custom_id contain this text. Example: sku-001.
asindata_collections_listList the Collections (scheduled batches of up to 15,000 requests) in your account, with filters and paging.Read-onlyList Collections
List the Collections (scheduled batches of up to 15,000 requests) in your account, with filters and paging. Returns collections with id, name, schedule, status (idle, queued, running), request and result counts, plus paging totals. Use this to find a collection ID. Rate-limited to 60 calls per minute.
Inputs
created_afterstring- Only collections created after this ISO UTC time. Example: 2026-01-01T00:00:00Z.
created_beforestring- Only collections created before this ISO UTC time. Example: 2026-12-31T23:59:59Z.
destination_idstring- Only collections that upload to this destination. Example: ABCDEFG.
last_run_afterstring- Only collections last run after this ISO UTC time. Example: 2026-11-01T00:00:00Z.
last_run_beforestring- Only collections last run before this ISO UTC time. Example: 2026-11-30T23:59:59Z.
only_with_resultsboolean- Only collections that have result sets. Example: true.
only_without_resultsboolean- Only collections that have never produced results. Example: false.
pageinteger- Page number, starting at 1. Example: 1.
page_sizeinteger- Collections per page, default 25, maximum 1000. Example: 25.
search_termstring- Only collections whose name contains this text. Example: price.
search_typestring- How search_term matches: contains (default, all words in name or id), starts_with, ends_with or exact. Example: contains.one of
containsstarts_withends_withexact sort_bystring- Sort field. Example: created_at.one of
created_atlast_runnameprioritystatus sort_directionstring- Sort direction. Defaults to ascending. Example: descending.one of
ascendingdescending statusstring- Only collections in this state. Defaults to all. Example: idle.one of
allidlequeuedrunning
asindata_destinations_listList the cloud storage Destinations (Amazon S3, Google Cloud Storage, Azure Blob, Alibaba OSS) that result sets can upload to.Read-onlyList Destinations
List the cloud storage Destinations (Amazon S3, Google Cloud Storage, Azure Blob, Alibaba OSS) that result sets can upload to. Returns destinations with id, name, type and enabled, 10 per page. Use this to get destination_ids for collections.
Inputs
pageinteger- Page number, starting at 1. Example: 1.
search_termstring- Only destinations whose name contains this text. Example: s3.
sort_bystring- Sort field. Example: name.one of
typename sort_directionstring- Sort direction. Defaults to ascending. Example: ascending.one of
ascendingdescending
asindata_error_logs_listList the error logs for failed requests in your account (failed requests are not charged).Read-onlyList Error Logs
List the error logs for failed requests in your account (failed requests are not charged). Returns logs with id, engine URL, parameters, error text, count and dates, 10 per page. Use this to debug failing requests.
Inputs
pageinteger- Page number, starting at 1. Example: 1.
search_termstring- Only logs whose parameters contain this text. Example: B073JYC4XM.
sort_bystring- Sort field. Example: date.one of
datecount sort_directionstring- Sort direction. Defaults to ascending. Example: descending.one of
ascendingdescending
asindata_offers_getGet the seller offers (other sellers' prices) for an Amazon product, with condition, Prime and shipping filters.Read-onlyGet Amazon Offers
Get the seller offers (other sellers' prices) for an Amazon product, with condition, Prime and shipping filters. Returns offers with each seller's price, condition, delivery, Prime eligibility and seller rating, plus the product summary and pagination. Use this to compare sellers. Use asindata_product_get for product details.
Inputs
amazon_domainstring- Amazon site to query, for example amazon.com, amazon.co.uk, amazon.de, amazon.co.jp. See the supported domains list in the ASIN Data API docs. Example: amazon.com.
asinstring- Amazon ASIN, used with amazon_domain. Send asin or url. Example: B073JYC4XM.
exclude_fieldsstring- Comma-separated JSON fields to drop from the response, in dot notation. Example: product.images,product.videos.
include_fieldsstring- Comma-separated JSON fields to keep in the response, in dot notation, to shrink it. Example: product.title,product.buybox_winner.price.
include_htmlboolean- Include the raw Amazon HTML in the response (much larger). Example: false.
max_pageinteger- Fetch pages from page through max_page in one call and join them. Each page costs a request credit. Example: 3.
offers_condition_newboolean- Only new-condition offers. Example: true.
offers_condition_used_acceptableboolean- Only used, acceptable offers. Example: false.
offers_condition_used_goodboolean- Only used, good offers. Example: false.
offers_condition_used_like_newboolean- Only used, like-new offers. Example: false.
offers_condition_used_very_goodboolean- Only used, very good offers. Example: false.
offers_free_shippingboolean- Only offers with free shipping. Example: false.
offers_primeboolean- Only Prime-eligible offers. Example: true.
pageinteger- Page of offers to return. Check pagination.total_pages in the response. Example: 1.
show_different_asinsboolean- Include offers Amazon shows for other ASINs (for example when the ASIN is out of stock). Example: false.
skip_on_incidentstring- Refuse to serve (and charge for) the request during a live parsing incident: all (degraded or major) or major_only. Example: major_only.one of
allmajor_only urlstring- Amazon product page URL; overrides asin and amazon_domain. Example: https://www.amazon.com/dp/B073JYC4XM.
asindata_product_getGet the full details of one Amazon product by ASIN, GTIN/UPC/EAN/ISBN or product URL.Read-onlyGet Amazon Product
Get the full details of one Amazon product by ASIN, GTIN/UPC/EAN/ISBN or product URL. Returns product with title, brand, price and buybox winner, ratings and review counts, images, feature bullets, specifications, variants, categories and bestseller ranks. Use this for one known product. Use asindata_search to find products. Each call uses one request credit.
Inputs
amazon_domainstring- Amazon site to query, for example amazon.com, amazon.co.uk, amazon.de, amazon.co.jp. See the supported domains list in the ASIN Data API docs. Example: amazon.com.
asinstring- Amazon ASIN, used with amazon_domain. Send asin, gtin or url. Example: B073JYC4XM.
exclude_fieldsstring- Comma-separated JSON fields to drop from the response, in dot notation. Example: product.images,product.videos.
gtinstring- GTIN, ISBN, UPC or EAN; converted to an ASIN first, used with amazon_domain. Example: 0711719541028.
include_fieldsstring- Comma-separated JSON fields to keep in the response, in dot notation, to shrink it. Example: product.title,product.buybox_winner.price.
include_htmlboolean- Include the raw Amazon HTML in the response (much larger). Example: false.
include_summarization_attributesboolean- Also return summarization_attributes and customers_say (review highlights). Example: true.
skip_gtin_cacheboolean- Force a fresh GTIN-to-ASIN lookup instead of the 2-month cache. Example: false.
skip_on_incidentstring- Refuse to serve (and charge for) the request during a live parsing incident: all (degraded or major) or major_only. Example: major_only.one of
allmajor_only urlstring- Amazon product page URL; overrides asin and amazon_domain. Example: https://www.amazon.com/dp/B073JYC4XM.
asindata_result_set_getGet one result set of a Collection with its download links.Read-onlyGet Result Set
Get one result set of a Collection with its download links. Returns timings, completed and failed counts, download_links (a JSON file per page and an all-pages zip), and webhook and destination delivery status. Download the linked files to read the results.
Inputs
collection_idstringrequired- Collection ID. Get it from asindata_collections_list or the create response. Example: F994420D.
result_set_idintegerrequired- Result Set ID within the collection, from asindata_result_sets_list (1, 2, 3 ...). Example: 1.
asindata_result_sets_listList a Collection's result sets (one per run), newest first.Read-onlyList Result Sets
List a Collection's result sets (one per run), newest first. Result sets are kept for 14 days. Returns results with each set's id, started_at, ended_at, expires_at and request counts, plus the collection summary. Use asindata_result_set_get for a set's download links.
Inputs
collection_idstringrequired- Collection ID. Get it from asindata_collections_list or the create response. Example: F994420D.
asindata_searchSearch Amazon for products by keyword, or read an Amazon search results URL.Read-onlySearch Amazon Products
Search Amazon for products by keyword, or read an Amazon search results URL. Returns search_results with each product's ASIN, title, link, price, rating, reviews total, sponsored flag and position, plus refinements and pagination. Use this to find products. Use asindata_product_get for one product's full details. Each page uses one request credit.
Inputs
amazon_domainstring- Amazon site to query, for example amazon.com, amazon.co.uk, amazon.de, amazon.co.jp. See the supported domains list in the ASIN Data API docs. Example: amazon.com.
category_idstring- Limit the search to this Amazon category (node) ID. Example: 172282.
direct_searchboolean- Search the exact term without Amazon's spelling correction. Example: false.
exclude_fieldsstring- Comma-separated JSON fields to drop from the response, in dot notation. Example: product.images,product.videos.
exclude_sponsoredboolean- Leave out sponsored results. Example: true.
include_fieldsstring- Comma-separated JSON fields to keep in the response, in dot notation, to shrink it. Example: product.title,product.buybox_winner.price.
include_htmlboolean- Include the raw Amazon HTML in the response (much larger). Example: false.
max_pageinteger- Fetch pages from page through max_page in one call and join them. Each page costs a request credit. Example: 3.
pageinteger- Page of results to return. Check pagination.total_pages in the response. Example: 1.
refinementsstring- Comma-separated refinement values (from the refinements in a previous response) to filter by rating, price, brand and so on. Example: p_72/1248879011,p_89/Apple.
search_termstring- Keywords to search for. Send search_term or url. Example: wireless earbuds.
skip_on_incidentstring- Refuse to serve (and charge for) the request during a live parsing incident: all (degraded or major) or major_only. Example: major_only.one of
allmajor_only sort_bystring- Sort order. Example: featured.one of
most_recentprice_low_to_highprice_high_to_lowfeaturedaverage_review urlstring- Amazon search results URL to read instead of search_term. Example: https://www.amazon.com/s?k=wireless+earbuds.
asindata_collection_createCreate a Collection: a named batch of Product Data requests that runs on a schedule or on demand and produces downloadable result sets.WriteCreate Collection
Create a Collection: a named batch of Product Data requests that runs on a schedule or on demand and produces downloadable result sets. Returns the new collection with its id. Then add requests with asindata_collection_requests_add and run it with asindata_collection_start (or let the schedule run it).
Inputs
namestringrequired- Collection name. Example: Daily price tracker.
destination_idsarray- Destination IDs (cloud storage buckets set up in ASIN Data API) to upload result sets to. Example: ["ABCDEFG"]
enabledboolean- Whether the collection runs on its schedule. Disabled collections only run when started. Example: true.
notification_as_csvboolean- Include CSV download links in notifications. Example: false.
notification_as_jsonboolean- Include JSON download links in notifications. Example: true.
notification_as_jsonlinesboolean- Include JSON Lines download links in notifications. Example: false.
notification_csv_fieldsstring- Comma-separated fields (dot notation) to put in CSV results. Example: product.asin,product.title,product.buybox_winner.price.value.
notification_emailstring- Email address told when a result set is ready. Example: ops@example.com.
notification_webhookstring- URL that receives a POST when a result set is ready. Example: https://example.com/hooks/asin.
prioritystring- Queue priority when several collections are waiting. Defaults to normal. Example: normal.one of
highesthighnormallowlowest requests_typestring- Lock the collection to one request type (cannot be changed later). mixed allows any. Example: product.one of
mixedproductofferssearchcategory schedule_days_of_montharray- Days of the month to run (1-31) for monthly and minutes schedules. Example: [1, 15]
schedule_days_of_weekarray- Days of the week to run (0 = Sunday to 6 = Saturday) for weekly and minutes schedules. Example: [1, 3]
schedule_hoursarray- Hours of the day (0-23, UTC) to run for minutes, daily, weekly and monthly schedules. Example: [9, 17]
schedule_minutesstring- Frequency for the minutes schedule. Example: every_hour.one of
every_minuteevery_5_minutesevery_10_minutesevery_15_minutesevery_20_minutesevery_25_minutesevery_30_minutesevery_hour schedule_typestring- How the collection runs: manual (only when started), minutes, daily, weekly or monthly. Example: daily.one of
manualminutesdailyweeklymonthly
asindata_collection_request_updateUpdate one request in a Collection.WriteUpdate Collection Request
Update one request in a Collection. Only works while it is not running. Returns the updated request fields. Send the fields to change, using the Product Data parameters.
- Idempotent
Inputs
collection_idstringrequired- Collection ID. Get it from asindata_collections_list or the create response. Example: F994420D.
requestobjectrequired- Fields to change on the request, using Product Data parameters such as asin, amazon_domain or custom_id. Example: {"asin": "B08N5WRWNW", "amazon_domain": "amazon.com"}
request_idstringrequired- ID of a request in the collection, from asindata_collection_requests_list. Example: ABCDEFGHIJKLMNOP.
asindata_collection_requests_addAdd up to 1000 Product Data requests to a Collection in one call.WriteAdd Collection Requests
Add up to 1000 Product Data requests to a Collection in one call. Only works while it is not running; call sequentially, not in parallel. Returns success and the updated request counts. Each request uses the same parameters as the Product Data tools (type plus asin, search_term and so on), with an optional custom_id of your own.
Inputs
collection_idstringrequired- Collection ID. Get it from asindata_collections_list or the create response. Example: F994420D.
requestsarrayrequired- Requests to add, each an object with type (product, search, category or offers) and that type's parameters such as amazon_domain and asin, plus an optional custom_id. Example: [{"type": "product", "amazon_domain": "amazon.com", "asin": "B073JYC4XM", "custom_id": "sku-001"}]
asindata_collection_startStart running a Collection now.WriteStart Collection
Start running a Collection now. Your account needs enough credits for all its requests. Returns success or the reason it could not start (for example not enough credits). Use asindata_collection_get to watch its status and asindata_result_sets_list for the results.
Inputs
collection_idstringrequired- Collection ID. Get it from asindata_collections_list or the create response. Example: F994420D.
asindata_collection_stopStop a queued or running Collection.WriteStop Collection
Stop a queued or running Collection. A queued collection's credits are refunded; a running one is not refunded. Returns success or the reason it could not stop. Use asindata_collections_stop_all to stop every collection.
- Idempotent
Inputs
collection_idstringrequired- Collection ID. Get it from asindata_collections_list or the create response. Example: F994420D.
asindata_collection_updateUpdate a Collection's name, schedule, priority, destinations or notifications.WriteUpdate Collection
Update a Collection's name, schedule, priority, destinations or notifications. Only works while it is not running. Returns the updated collection. Use asindata_collection_requests_add to add requests.
- Idempotent
Inputs
collection_idstringrequired- Collection ID. Get it from asindata_collections_list or the create response. Example: F994420D.
destination_idsarray- Destination IDs (cloud storage buckets set up in ASIN Data API) to upload result sets to. Example: ["ABCDEFG"]
enabledboolean- Whether the collection runs on its schedule. Disabled collections only run when started. Example: true.
namestring- Collection name. Example: Daily price tracker.
notification_as_csvboolean- Include CSV download links in notifications. Example: false.
notification_as_jsonboolean- Include JSON download links in notifications. Example: true.
notification_as_jsonlinesboolean- Include JSON Lines download links in notifications. Example: false.
notification_csv_fieldsstring- Comma-separated fields (dot notation) to put in CSV results. Example: product.asin,product.title,product.buybox_winner.price.value.
notification_emailstring- Email address told when a result set is ready. Example: ops@example.com.
notification_webhookstring- URL that receives a POST when a result set is ready. Example: https://example.com/hooks/asin.
prioritystring- Queue priority when several collections are waiting. Defaults to normal. Example: normal.one of
highesthighnormallowlowest schedule_days_of_montharray- Days of the month to run (1-31) for monthly and minutes schedules. Example: [1, 15]
schedule_days_of_weekarray- Days of the week to run (0 = Sunday to 6 = Saturday) for weekly and minutes schedules. Example: [1, 3]
schedule_hoursarray- Hours of the day (0-23, UTC) to run for minutes, daily, weekly and monthly schedules. Example: [9, 17]
schedule_minutesstring- Frequency for the minutes schedule. Example: every_hour.one of
every_minuteevery_5_minutesevery_10_minutesevery_15_minutesevery_20_minutesevery_25_minutesevery_30_minutesevery_hour schedule_typestring- How the collection runs: manual (only when started), minutes, daily, weekly or monthly. Example: daily.one of
manualminutesdailyweeklymonthly
asindata_collections_stop_allStop every queued or running Collection in the account and set them back to idle.WriteStop All Collections
Stop every queued or running Collection in the account and set them back to idle. Returns how many collections were stopped and how many failed to stop. Use this in an emergency. Use asindata_collection_stop for one collection.
- Idempotent
Inputs
This tool takes no inputs.
asindata_result_set_webhook_resendSend a result set's completion webhook again to the collection's notification_webhook.WriteResend Result Set Webhook
Send a result set's completion webhook again to the collection's notification_webhook. Returns success. Use this when your webhook endpoint missed the first delivery.
Inputs
collection_idstringrequired- Collection ID. Get it from asindata_collections_list or the create response. Example: F994420D.
result_set_idintegerrequired- Result Set ID within the collection, from asindata_result_sets_list (1, 2, 3 ...). Example: 1.
asindata_collection_deleteDelete a Collection with its requests and result sets.DestructiveDelete Collection
Delete a Collection with its requests and result sets. Only works while it is not running. Returns success and a message. Use asindata_collection_stop first if it is running.
- Idempotent
Inputs
collection_idstringrequired- Collection ID. Get it from asindata_collections_list or the create response. Example: F994420D.
asindata_collection_request_deleteDelete one request from a Collection.DestructiveDelete Collection Request
Delete one request from a Collection. Only works while it is not running. Returns success and a message. Use asindata_collection_requests_clear to remove all requests.
- Idempotent
Inputs
collection_idstringrequired- Collection ID. Get it from asindata_collections_list or the create response. Example: F994420D.
request_idstringrequired- ID of a request in the collection, from asindata_collection_requests_list. Example: ABCDEFGHIJKLMNOP.
asindata_collection_requests_clearDelete all requests from a Collection, keeping the collection and its settings.DestructiveClear Collection Requests
Delete all requests from a Collection, keeping the collection and its settings. Only works while it is not running. Returns success and a message. Use asindata_collection_request_delete for one request.
- Idempotent
Inputs
collection_idstringrequired- Collection ID. Get it from asindata_collections_list or the create response. Example: F994420D.
asindata_destination_deleteDelete a Destination.DestructiveDelete Destination
Delete a Destination. Collections stop uploading to it. Returns success and a message. Use asindata_destinations_list to find IDs.
- Idempotent
Inputs
destination_idstringrequired- Destination ID from asindata_destinations_list. Example: ABCDEFG.
No tools match.