NAiOS IconNAiOS Logo
Volver al catálogo

Bestbuy

bestbuy

Best Buy offers a suite of APIs providing access to product, store, category, and recommendation data.

Acciones
8
Triggers
0
Autenticación
OAuth gestionado
No
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (8)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Get CategoriesBESTBUY_GET_CATEGORIESAcción

Tool to retrieve best buy product categories. use when you need to list or filter categories in the catalog.

Parámetros de entrada

  • idstring

    Filter by category ID(s), pipe-separated

  • namestring

    Filter by category name(s), pipe-separated

  • pageinteger

    Page number to retrieve (1-based)

  • showstring

    Comma-separated list of fields to include in each category

  • sortstring

    Sort order, e.g., 'name.asc' or 'id.desc'

  • formatstringenum

    Response format (json or xml)

    jsonxml
  • pageSizeinteger

    Number of categories per page (1-100)

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Category DetailsBESTBUY_GET_CATEGORY_DETAILSAcción

Tool to retrieve detailed information about a best buy category by its id. use when you need enriched metadata about a specific category.

Parámetros de entrada

  • idstringObligatorio

    The ID of the category to retrieve

  • pageinteger

    Page number to retrieve

  • showstring

    Comma-delimited list of fields to include in the response

  • apiKeystringObligatorio

    Your Best Buy Developer API key

  • formatstringenum

    Response format, json or xml

    jsonxml
  • pageSizeinteger

    Number of records to return per page

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Product Details by SKUBESTBUY_GET_PRODUCT_DETAILSAcción

Tool to retrieve detailed information about a specific product by sku. use after obtaining a valid sku to fetch its attributes.

Parámetros de entrada

  • skustringObligatorio

    The SKU (Stock Keeping Unit) of the product to retrieve.

  • showstring

    Comma-separated list of additional fields to include in the response.

  • formatstringenum

    Response format. Defaults to json.

    jsonxml

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get ProductsBESTBUY_GET_PRODUCTSAcción

Tool 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.'

Parámetros de entrada

  • skuinteger

    Filter for a specific SKU

  • upcstring

    Filter for a specific UPC

  • namestring

    Filter by product name with wildcard, e.g., name="iPad*"

  • pageinteger

    Page number to retrieve

  • showstring

    Comma-separated list of attributes to include in response

  • sortstring

    Sort format, e.g., 'name.asc' or 'salePrice.dsc'

  • pageSizeinteger

    Number of products per page (1-100)

  • salePricestring

    Filter by sale price, e.g., 'salePrice>100'

  • categoryPath.idstring

    Filter products by category ID

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Review DetailsBESTBUY_GET_REVIEW_DETAILSAcción

Tool to retrieve detailed information for a specific review by id. use after confirming the review id.

Parámetros de entrada

  • idstringObligatorio

    The unique identifier of the review to retrieve

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Product ReviewsBESTBUY_GET_REVIEWSAcción

Tool to retrieve product reviews. use when you need customer feedback with filters or sorting. use after obtaining product skus.

Parámetros de entrada

  • skustring

    Filter reviews by product SKU

  • pageinteger

    Page number for pagination

  • showstring

    Comma-separated fields to include in response

  • sortstring

    Sort expression, e.g., 'submissionTime.dsc'

  • formatstringenum

    Response format, 'json' (default) or 'xml'

    jsonxml
  • maxScoreinteger

    Maximum rating score (1-5)

  • minScoreinteger

    Minimum rating score (1-5)

  • pageSizeinteger

    Number of reviews per page

  • reviewerstring

    Filter reviews by reviewer name

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Store DetailsBESTBUY_GET_STORE_DETAILSAcción

Tool to retrieve detailed information about a specific best buy store. use when you have a valid store id.

Parámetros de entrada

  • showstring

    Comma-separated list of fields to include in the response (e.g., 'storeId,name,address')

  • storeIdstringObligatorio

    Unique identifier for the Best Buy store

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Best Buy StoresBESTBUY_GET_STORESAcción

Tool 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.

Parámetros de entrada

  • geoobject

    Geographic filtering parameters for stores search.

  • citystring

    Filter stores by city name

  • pageinteger

    Page number to retrieve (must be > 0)

  • showstring

    Comma-separated list of store fields to include in the response

  • sortstring

    Sort directive, e.g., 'city.asc' or 'name.desc'

  • statestring

    Filter stores by two-letter state code

  • regionstring

    Filter stores by region

  • storeIdinteger

    Specific store ID to retrieve

  • pageSizeinteger

    Number of results per page (must be > 0)

  • servicesstring

    Comma-separated list of services to filter by

  • storeTypestring

    Filter stores by store type

  • postalCodestring

    Filter stores by postal code

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not