# Particl

> Retail intelligence platform for searching competitors, analyzing product catalogs, tracking pricing, and surfacing sales trends across e-commerce brands.

Source: https://cotera.co/docs/reference/tools/individual-tools/particl

---

**Authentication Type:** API Key
**Description:** Retail intelligence platform for searching competitors, analyzing product catalogs, tracking pricing, and surfacing sales trends across e-commerce brands.

***

## Authentication

To authenticate with Particl, you'll need an API key from your Particl account:

1. Sign in at [app.particl.com](https://app.particl.com)
2. Navigate to the **Claude & ChatGPT** page in your dashboard
3. Click **Enable MCP** to generate your API key
4. Copy the generated key

You'll need to provide:

* **apiKey** `string`: Your Particl API key

> **Note:** Most operations consume export credits, which are shared with CSV exports in the Particl dashboard. Use Search Companies and Get Product Types for free to explore before running paid queries.

***

## Company Discovery

### Search Companies

Search for companies by name or domain. Returns matching companies with basic metadata. Use this to find company IDs for other Particl tools.

**Operation Type:** Query (Read)

**Parameters:**

* **search** `string` (required): Search term — company name or domain (max 200 characters)
* **page\_size** `number` (nullable): Results per page (default: 25, max: 100)
* **page** `number` (nullable): Page number, 0-indexed (default: 0)
* **sort\_by** `string` (nullable): Sort order — "popularity" (default) or "start\_date"
* **country\_code** `string` (nullable): Filter by country code (default: "US"). Common values: "US", "CA", "AU", "GB". Pass empty string to search all countries.

**Returns:**

* **result** `object`: Search results containing matched companies with IDs, names, domains, and metadata

**Example Usage:**

```json
{
  "search": "lululemon",
  "country_code": "US",
  "page_size": 10
}
```

***

### Get Product Types

Browse the product type taxonomy to discover valid categories for filtering. Call with no parameters to get root-level categories, then pass a product type ID to drill into subcategories.

**Operation Type:** Query (Read)

**Parameters:**

* **parent\_product\_type\_id** `string` (nullable): Get child categories under this product type. Omit to get root-level categories.

**Returns:**

* **result** `object`: List of product type categories with IDs and names

**Example Usage:**

```json
{}
```

***

## Company Analysis

### Get Company Details

Get metadata for a specific company — name, domain, country, and tracking start date.

**Operation Type:** Query (Read)

**Parameters:**

* **company\_id** `string` (required): Particl company ID (e.g., "lululemon-com"). Use Search Companies to find this.

**Returns:**

* **result** `object`: Company metadata including name, domain, country, and tracking information

**Example Usage:**

```json
{
  "company_id": "lululemon-com"
}
```

***

### Get Company Products

Deep-dive into a specific company's product catalog. The primary tool for company-level analysis — supports full pagination, custom date ranges, and filtering by category, keyword, brand, and price.

**Operation Type:** Query (Read)

**Parameters:**

* **company\_id** `string` (required): Particl company ID (e.g., "lululemon-com")
* **product\_type\_id** `string` (nullable): Product type UUID from Get Product Types
* **keyword** `string` (nullable): Tag filter (e.g., "wool", "recycled", "organic"). Searches product tags only, not titles.
* **title\_search** `string` (nullable): Search products by title (e.g., "tank top", "winter jacket"). Use this instead of keyword for title matching.
* **brand** `string` (nullable): Filter by brand name
* **min\_price** `number` (nullable): Minimum price filter
* **max\_price** `number` (nullable): Maximum price filter
* **sort\_by** `string` (nullable): Sort field — "sales\_revenue" (default), "sales\_volume", "price", or "launch\_date"
* **sort\_direction** `string` (nullable): Sort direction — "desc" (default) or "asc"
* **page\_size** `number` (nullable): Results per page (default: 25, max: 100)
* **page** `number` (nullable): Page number, 0-indexed (default: 0)
* **start\_date** `string` (nullable): Start of date range (YYYY-MM-DD, defaults to \~30 days ago)
* **end\_date** `string` (nullable): End of date range (YYYY-MM-DD, defaults to today)
* **confidence\_threshold** `number` (nullable): Minimum data confidence score (0-10, default: 6.0). Lower to 0 to include all products.

**Returns:**

* **result** `object`: Array of products with sales data, pricing, brand, and category information

**Example Usage:**

```json
{
  "company_id": "lululemon-com",
  "sort_by": "sales_revenue",
  "page_size": 25,
  "min_price": 50,
  "max_price": 200
}
```

***

## Product Intelligence

### Get Product Details

Get full details for a specific product — pricing, brand, gender, ratings, reviews, images, materials, keywords, and category data.

**Operation Type:** Query (Read)

**Parameters:**

* **company\_id** `string` (required): Particl company ID (e.g., "lululemon-com")
* **product\_id** `string` (required): The product ID from Get Company Products

**Returns:**

* **result** `object`: Full product details including pricing, brand, materials, ratings, images, and category data

**Example Usage:**

```json
{
  "company_id": "lululemon-com",
  "product_id": "abc123"
}
```

***

### Get Product Variants

Get variant-level data for a specific product — colors, sizes, individual pricing, and sales.

**Operation Type:** Query (Read)

**Parameters:**

* **company\_id** `string` (required): Particl company ID (e.g., "lululemon-com")
* **product\_id** `string` (required): The product ID from Get Company Products
* **start\_date** `string` (nullable): Start of sales data window (YYYY-MM-DD, defaults to \~30 days ago)
* **end\_date** `string` (nullable): End of sales data window (YYYY-MM-DD, defaults to today)

**Returns:**

* **result** `object`: Variant-level data including colors, sizes, individual pricing, and sales figures

**Example Usage:**

```json
{
  "company_id": "lululemon-com",
  "product_id": "abc123",
  "start_date": "2026-03-01",
  "end_date": "2026-03-31"
}
```

***

### Get Product Breakdown

Get product data broken down by a specific attribute. Useful for understanding product mix — e.g., which colors sell best, which brands dominate, or what materials are most popular.

**Operation Type:** Query (Read)

**Parameters:**

* **company\_id** `string` (required): Particl company ID (e.g., "lululemon-com")
* **breakdown\_type** `string` (required): Attribute to break down by — "keyword", "material", "colors", "brands", "gender", or "locations"
* **product\_type\_id** `string` (nullable): Product type UUID from Get Product Types to filter by category
* **keyword** `string` (nullable): Tag filter (e.g., "sustainable"). Searches product tags only.
* **start\_date** `string` (nullable): Start of date range (YYYY-MM-DD, defaults to \~30 days ago)
* **end\_date** `string` (nullable): End of date range (YYYY-MM-DD, defaults to today)
* **confidence\_threshold** `number` (nullable): Minimum data confidence score (0-10, default: 6.0)

**Returns:**

* **result** `object`: Breakdown data showing distribution across the selected attribute with sales and volume metrics

**Example Usage:**

```json
{
  "company_id": "lululemon-com",
  "breakdown_type": "colors",
  "start_date": "2026-03-01",
  "end_date": "2026-03-31"
}
```

***

### Get Sales Timeseries

Get historical sales timeseries data for a company or a single product. Returns daily, weekly, or monthly data points showing revenue, volume, and pricing over time. Essential for understanding trends, seasonality, and growth.

**Operation Type:** Query (Read)

**Parameters:**

* **company\_id** `string` (required): Particl company ID (e.g., "lululemon-com")
* **product\_id** `string` (nullable): Optional product ID to get timeseries for a single product
* **product\_type\_id** `string` (nullable): Product type UUID from Get Product Types to filter by category
* **keyword** `string` (nullable): Tag filter (e.g., "sustainable"). Searches product tags only.
* **start\_date** `string` (nullable): Start of date range (YYYY-MM-DD, defaults to \~30 days ago)
* **end\_date** `string` (nullable): End of date range (YYYY-MM-DD, defaults to today)
* **aggregation\_type** `string` (nullable): Aggregation period — "daily", "weekly", or "monthly". Auto-selected if omitted.
* **confidence\_threshold** `number` (nullable): Minimum data confidence score (0-10, default: 6.0)

**Returns:**

* **result** `object`: Timeseries data points with revenue, volume, and pricing metrics over the specified period

**Example Usage:**

```json
{
  "company_id": "lululemon-com",
  "aggregation_type": "monthly",
  "start_date": "2025-01-01",
  "end_date": "2026-03-31"
}
```

***

## Common Use Cases

**Competitive Intelligence:**

* Track competitor product launches and pricing changes
* Compare product catalogs across rival brands
* Monitor which product categories are growing fastest

**Product Research:**

* Analyze best-selling products in any category
* Break down product mix by color, material, or brand
* Research pricing distribution for market positioning

**Trend Analysis:**

* Track sales trends over time with daily, weekly, or monthly data
* Identify seasonal patterns and growth trajectories
* Compare year-over-year performance for specific categories

**Market Sizing:**

* Estimate competitor revenue by product line
* Understand market share across brands in a category
* Identify emerging brands and products gaining traction