NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Bestbuy connects to a Nagent workspace with an API key. Once it is connected, agents can call 8 Bestbuy actions, such as "Get Categories", "Get Category Details" and "Get Product Details by SKU". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Bestbuy, with input parameters and output schema.
BESTBUY_GET_CATEGORIESTool to retrieve Best Buy product categories. Use when you need to list or filter categories in the catalog.
Input parameters
Filter by category ID(s), pipe-separated
Filter by category name(s), pipe-separated
Page number to retrieve (1-based)
Comma-separated list of fields to include in each category
Sort order, e.g., 'name.asc' or 'id.desc'
Response format (json or xml)
Number of categories per page (1-100)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BESTBUY_GET_CATEGORY_DETAILSTool to retrieve detailed information about a Best Buy category by its ID. Use when you need enriched metadata about a specific category.
Input parameters
The ID of the category to retrieve
Page number to retrieve
Comma-delimited list of fields to include in the response
Your Best Buy Developer API key
Response format, json or xml
Number of records to return per page
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BESTBUY_GET_PRODUCT_DETAILSTool to retrieve detailed information about a specific product by SKU. Use after obtaining a valid SKU to fetch its attributes.
Input parameters
The SKU (Stock Keeping Unit) of the product to retrieve.
Comma-separated list of additional fields to include in the response.
Response format. Defaults to json.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BESTBUY_GET_PRODUCTSTool to retrieve products from Best Buy. Use when you need to fetch product listings with optional filters and sorting. Example: 'Get products for category abcat0101000 sorted by salePrice.dsc.'
Input parameters
Filter for a specific SKU
Filter for a specific UPC
Filter by product name with wildcard, e.g., name="iPad*"
Page number to retrieve
Comma-separated list of attributes to include in response
Sort format, e.g., 'name.asc' or 'salePrice.dsc'
Number of products per page (1-100)
Filter by sale price, e.g., 'salePrice>100'
Filter products by category ID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BESTBUY_GET_REVIEW_DETAILSTool to retrieve detailed information for a specific review by ID. Use after confirming the review ID.
Input parameters
The unique identifier of the review to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BESTBUY_GET_REVIEWSTool to retrieve product reviews. Use when you need customer feedback with filters or sorting. Use after obtaining product SKUs.
Input parameters
Filter reviews by product SKU
Page number for pagination
Comma-separated fields to include in response
Sort expression, e.g., 'submissionTime.dsc'
Response format, 'json' (default) or 'xml'
Maximum rating score (1-5)
Minimum rating score (1-5)
Number of reviews per page
Filter reviews by reviewer name
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BESTBUY_GET_STORE_DETAILSTool to retrieve detailed information about a specific Best Buy store. Use when you have a valid store ID.
Input parameters
Comma-separated list of fields to include in the response (e.g., 'storeId,name,address')
Unique identifier for the Best Buy store
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BESTBUY_GET_STORESTool to retrieve a list of Best Buy stores. Use when you need store listings with optional filters or geo-search after confirming your API key.
Input parameters
Geographic filtering parameters for stores search.
Filter stores by city name
Page number to retrieve (must be > 0)
Comma-separated list of store fields to include in the response
Sort directive, e.g., 'city.asc' or 'name.desc'
Filter stores by two-letter state code
Filter stores by region
Specific store ID to retrieve
Number of results per page (must be > 0)
Comma-separated list of services to filter by
Filter stores by store type
Filter stores by postal code
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 8 Bestbuy actions on Nagent, including "Get Categories", "Get Category Details" and "Get Product Details by SKU". Get Categories: Retrieve Best Buy product categories. Each action is listed on this page with its input parameters and its output.
Bestbuy connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
It also takes 7 optional inputs: id, name, page, show, sort, format and pageSize. It returns data, error and successful.