Particl Market Research

Browse the product type taxonomy to discover valid categories for filtering. Use the returned product_type_id values in other tools' product_type_id parameter. How to use: 1. Call with no parameters to get root-level categories 2. Pass a product_type_id as parent_product_type_id to see its subcategories 3. Keep drilling deeper until you find the right category 4. Use the chosen product_type_id as the product_type_id filter in other tools Args: parent_product_type_id: Get child categories under this product type. Omit to get root-level categories. Credits: Free — no credits charged. Returns: List of product type categories with product_type_id and name

get_product_types

Get detailed information about a specific company. Args: company_id: The Particl company ID (e.g., '1234567') analysis_goal: Brief summary of the user's research objective for this query. Fill this in based on what the user is trying to learn. Omit if unknown. Credits: 1 credit per call (not charged if no data is returned). Returns: Company profile including name, domain, country, vertical, start date, product count, whether product-level data exists (has_product_data), and top product categories. The has_product_data field indicates whether the company has product-level data. When has_sales_data is false, sales fields are not populated for this company. When has_pricing_data is false, pricing fields are not populated.

get_company_details

Get promotional events for a company — product launches, sales, restocks, price changes, and discounts — with associated marketing assets and products. Supports pagination. Use search_companies first to find the company_id. Args: company_id: The Particl company ID (e.g., '1234567') - required start_date: Start of date range (ISO format, e.g., '2025-01-01'). Defaults to ~30 days ago. end_date: End of date range (ISO format, e.g., '2025-01-31'). Defaults to ~2 days ago. event_types: Filter by event type(s). Common values: 'Promotion', 'Product Release', 'Special Event', 'Collaboration', 'Restock'. Many other values exist — call without this filter first to discover available types for a company. channels: Filter by marketing channel(s). Options: 'email', 'instagram_post', 'facebook_ads', 'sms', 'homepage_screenshot' page_size: Results per page (default 25, max 100). Set higher to get more results per call. page: Page number (0-indexed, default 0). Increment to get additional pages of results. analysis_goal: Brief summary of the user's research objective for this query. Fill this in based on what the user is trying to learn. Omit if unknown. Credits: 1 per row returned (e.g., page_size=10 costs up to 10 credits). Returns: List of promotional events with associated marketing assets and products. Includes has_more and total_count for pagination.

get_company_events

Deep-dive into a specific company's product catalog. Supports pagination — use page and page_size to retrieve more than the default 25 results. Use search_companies first to find the company_id. Args: company_id: The Particl company ID (e.g., '1234567') - required. Use search_companies to find this. product_type_id: Product type UUID from get_product_types. Pass the product_type_id value, not the name. keyword: Filter by keyword/tag (e.g., 'wool', 'recycled'). Searches product tags only, NOT product titles. Use title_search to search by title. title_search: Search products by title (e.g., 'tank top', 'winter jacket'). Matches against product display title. brand: Filter by brand name min_price: Minimum price filter max_price: Maximum price filter sort_by: Sort by 'sales_revenue' (default), 'sales_volume', 'price', or 'launch_date' sort_direction: 'desc' (default) or 'asc' page_size: Results per page (default 25, max 100). Set to 100 to get up to 100 results in one call. page: Page number (0-indexed, default 0). Increment to get additional pages of results. start_date: Start of sales data aggregation window (ISO format, e.g., '2025-01-01'). Omit both dates for the default last-4-full-weeks window; give only start_date to run through today. end_date: End of sales data aggregation window (ISO format, e.g., '2025-01-31'). Give only end_date for the 30 days ending there. The resolved window is echoed in date_range. confidence_threshold: Minimum data confidence score (0-10) for included products. Defaults to 6.0, which filters out products with unreliable sales estimates (e.g., gap-filled or anomalous data). You usually don't need to change this. Lower it (e.g., to 0) only if you're looking for a specific product that isn't appearing in results — it may be hidden due to lower data confidence. Set to 0 to include all products regardless of data quality. analysis_goal: Brief summary of the user's research objective for this query. Fill this in based on what the user is trying to learn. Omit if unknown. Credits: 1 per row returned (e.g., page_size=25 costs up to 25 credits). Returns: List of products from the specified company with pricing, sales estimates, and metadata. Includes has_more and total_count for pagination.

get_company_products

Check your remaining export credits. Credits: Free — no credits charged. Returns: Credit balance including total limit, used, and remaining credits

get_credit_balance

Get pricing analysis for a market or category. Args: product_type_id: Product type UUID from get_product_types. Pass the product_type_id value, not the name. keyword: Filter by keyword/tag end_date: End of trailing 30-day analysis window (ISO format, e.g., '2025-01-15'). Defaults to ~2 days ago. analysis_goal: Brief summary of the user's research objective for this query. Fill this in based on what the user is trying to learn. Omit if unknown. Credits: 1 credit per call (not charged if no data is returned). Returns: Pricing summary with average, median, range, and distribution buckets

get_market_pricing_analysis

Get aggregated market-level sales data with monthly timeseries. Returns total market revenue and volume, plus monthly timeseries showing how the market is trending over time. Use with get_market_top_companies and get_market_top_products for complete market analysis. Args: product_type_id: Product type UUID from get_product_types. Pass the product_type_id value, not the name. keyword: Filter by keyword/tag (e.g., 'sustainable', 'organic') end_date: End of trailing analysis window (ISO format, e.g., '2025-01-15'). Defaults to ~2 days ago. analysis_goal: Brief summary of the user's research objective for this query. Fill this in based on what the user is trying to learn. Omit if unknown. Credits: 1 credit per call (not charged if no data is returned). Returns: Market sales summary with total revenue/volume and monthly timeseries

get_market_sales

Get full details of a specific marketing asset — email content, social post with engagement metrics, ad creative with cards, or homepage screenshot. Args: company_id: The Particl company ID (e.g., '1234567') - required asset_id: The asset ID - required analysis_goal: Brief summary of the user's research objective for this query. Fill this in based on what the user is trying to learn. Omit if unknown. Credits: 1 credit per call (not charged if no data is returned). Returns: Full asset details including content, engagement metrics, metadata, and product_ids when available. Use product_ids with get_company_products to look up sales and revenue data for the featured products.

get_marketing_asset_details

List a company's marketing assets — emails, Instagram posts, Facebook/Meta ads, SMS messages, and homepage screenshots. Supports pagination. Use search_companies first to find the company_id. Args: company_id: The Particl company ID (e.g., '1234567') - required asset_types: Filter by asset type(s). Options: 'email', 'instagram_post', 'facebook_ads', 'sms', 'homepage_screenshot'. Defaults to all types. start_date: Start of date range (ISO format, e.g., '2025-01-01'). Defaults to ~30 days ago. end_date: End of date range (ISO format, e.g., '2025-01-31'). Defaults to ~2 days ago. page_size: Results per page (default 25, max 100). Set to 100 to get up to 100 results in one call. page: Page number (0-indexed, default 0). Increment to get additional pages of results. analysis_goal: Brief summary of the user's research objective for this query. Fill this in based on what the user is trying to learn. Omit if unknown. Credits: 1 per row returned (e.g., page_size=25 costs up to 25 credits). Returns: List of marketing assets with content, engagement metrics, and metadata. Includes has_more and total_count for pagination. Assets include product_ids when available — use these with get_company_products to look up sales and revenue data for the featured products.

get_company_marketing_assets

Get aggregated marketing engagement statistics for a company — posting frequency by type, average likes, engagement rate, most liked post, and posting hour distribution. Use search_companies first to find the company_id. Args: company_id: The Particl company ID (e.g., '1234567') - required analysis_goal: Brief summary of the user's research objective for this query. Fill this in based on what the user is trying to learn. Omit if unknown. Returns: total_assets: total number of marketing assets in the last 30 days assets_by_type: dict of asset counts keyed by type (e.g. {"instagram_post": 42, "email": 10}) engagement_metrics: dict of {avg_likes, avg_comments} keyed by type posting_hours: dict of hour-frequency lists keyed by type estimated_reach: dict of average follower counts keyed by type (e.g. {"instagram_post": 50000.0}) avg_likes: dict of average likes keyed by type (e.g. {"instagram_post": 1200.5}) engagement_rate: dict of engagement rate percentages keyed by type (e.g. {"instagram_post": 4.2}) most_liked_post: dict of most liked post details keyed by type Credits: 1 credit per call (not charged if no data is returned).

get_company_marketing_stats