Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to ASIN Data API

Scalekit connector
Open markdown

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

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. 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>
  3. Create the ASIN Data API connection

    In AgentKit > Connections, create an ASIN Data API connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. 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.actions
    const connector = 'asindata'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { 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 call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'asindata_account_get',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each 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 to execute_tool
Try in PlaygroundRequest a tool
  • asindata_account_getGet your ASIN Data API account usage and the platform status.Read-only

    Get 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-only

    Get 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-only

    Get 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_listList one page (1000 per page) of the requests in a Collection, or search them by text or custom_id.Read-only

    List 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-only

    List 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-only

    List 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-only

    List 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