# Retailed

Retailed is a global developer-first platform providing retail and resale marketplace APIs with access to product data, pricing information, and inventory management from major platforms like StockX, GOAT, Chrono24, and 50+ retail websites including sneakers, streetwear, watches, and luxury goods.

- **Category:** ecommerce
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 6
- **Triggers:** 0
- **Slug:** `RETAILED`
- **Version:** 20260316_00

## Tools

### Get GOAT Product Prices

**Slug:** `RETAILED_GET_GOAT_PRICES`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `size` | string | No | Specific product size (if applicable). |
| `country` | string | No | Country/market code for pricing (e.g., 'US', 'UK', 'EU'). |
| `product_id` | string | Yes | GOAT product ID to fetch prices for. Use numeric ID like '719082' or product slug. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get StockX Product

**Slug:** `RETAILED_GET_STOCK_X_PRODUCT`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sku` | string | No | StockX product SKU identifier StockX-specific; may not match SKUs from other marketplaces (e.g., GOAT). Normalize identifiers before cross-platform comparisons. |
| `url` | string | No | Direct StockX product URL |
| `include_market` | boolean | No | Whether to include detailed market data |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### StockX Search

**Slug:** `RETAILED_GET_STOCKX_SEARCH`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (default: 1) |
| `limit` | integer | No | Number of results per page (default: 10) |
| `query` | string | Yes | Search term for StockX products |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### StockX Trends

**Slug:** `RETAILED_GET_STOCKX_TRENDS`

Tool to get the latest trending products from StockX. Use when you want to discover current trending items.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (default: 1) |
| `order` | string ("asc" | "desc") | No | Sort order (ascending or descending) |
| `sort_by` | string | No | Sort field (e.g., popularity, price) |
| `per_page` | integer | No | Number of results per page (default: 20) |
| `product_type` | string | No | Filter by product type (e.g., sneakers, streetwear) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get API Usage

**Slug:** `RETAILED_GET_USAGE`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Products

**Slug:** `RETAILED_SEARCH_PRODUCTS`

Search 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (default: 1). |
| `sort` | string | No | Field to sort by. Prefix with '-' for descending order. |
| `limit` | integer | No | 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. |
| `domain` | string | No | Filter by domain (e.g., 'stockx.com', 'goat.com'). |
| `source` | string | No | Filter by source/marketplace name (e.g., 'stockx-us', 'goat-us'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |