Retailed connects to a Nagent workspace with an API key. Once it is connected, agents can call 6 Retailed actions, such as "Get GOAT Product Prices", "Get StockX Product" and "Get API Usage". 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 Retailed, with input parameters and output schema.
RETAILED_GET_GOAT_PRICESTool to retrieve pricing information for a specific product on GOAT. Use when you need up-to-date size-based pricing. Call after confirming product_id.
Input parameters
Specific product size (if applicable).
Country/market code for pricing (e.g., 'US', 'UK', 'EU').
GOAT product ID to fetch prices for. Use numeric ID like '719082' or product slug.
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
RETAILED_GET_STOCK_X_PRODUCTTool to retrieve detailed StockX product information, including variant-level data. Use when you need comprehensive metadata from StockX by SKU or URL. Response is structured per variant; aggregate price or inventory metrics across variants only after grouping by variant to avoid distortion.
Input parameters
StockX product SKU identifier StockX-specific; may not match SKUs from other marketplaces (e.g., GOAT). Normalize identifiers before cross-platform comparisons.
Direct StockX product URL
Whether to include detailed market data
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
RETAILED_GET_STOCKX_SEARCHTool to search StockX marketplace for products and pricing information. Use when you have a search term and need up-to-date listings on StockX. Note: SKU identifiers and size labels in results may differ from other marketplaces (e.g., GOAT); normalize these fields before cross-platform price comparisons.
Input parameters
Page number for pagination (default: 1)
Number of results per page (default: 10)
Search term for StockX products
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
RETAILED_GET_STOCKX_TRENDSTool to get the latest trending products from StockX. Use when you want to discover current trending items.
Input parameters
Page number for pagination (default: 1)
Sort order (ascending or descending)
Sort field (e.g., popularity, price)
Number of results per page (default: 20)
Filter by product type (e.g., sneakers, streetwear)
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
RETAILED_GET_USAGETool to retrieve current API usage statistics. The only mechanism to check remaining API credits; call proactively before long-running analyses to prevent mid-run quota exhaustion.
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
RETAILED_SEARCH_PRODUCTSSearch for products in Retailed database matching query criteria. Uses Retailed's granular querying language with support for filtering by name, SKU, brand. SKUs and size labels are not standardized across sources; normalize product IDs and size labels before comparing results across marketplaces.
Input parameters
Page number for pagination (default: 1).
Field to sort by. Prefix with '-' for descending order.
Number of products per page (default: 10, max: 100). Queries with many matches silently return only the first page; always manage `page` and `limit` explicitly when iterating full result sets.
Filter by domain (e.g., 'stockx.com', 'goat.com').
Filter by source/marketplace name (e.g., 'stockx-us', 'goat-us').
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 6 Retailed actions on Nagent, including "Get GOAT Product Prices", "Get StockX Product" and "Get API Usage". Get GOAT Product Prices: Retrieve pricing information for a specific product on GOAT. Each action is listed on this page with its input parameters and its output.
Retailed 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.
Get GOAT Product Prices takes 1 required input: product_id. It also takes 2 optional inputs: size and country. It returns data, error and successful.