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:

Sign in at app.particl.com
Navigate to the Claude & ChatGPT page in your dashboard
Click Enable MCP to generate your API key
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:

{
  "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:

{}

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:

{
  "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:

{
  "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:

{
  "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:

{
  "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:

{
  "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:

{
  "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