Coolpie.ai Documentation

Welcome to the official documentation for Coolpie.ai — the competitive price intelligence platform for e-commerce retailers.

Who is this for? This documentation covers both everyday users (merchandisers, pricing managers) and technical users who work with the platform's API and feed integrations.

What is Coolpie.ai?

Coolpie.ai is a competitor price monitoring and matching platform built for online retailers. It automatically pulls your product catalogue and competitor listings, matches products across stores, and helps you make faster, smarter pricing decisions.

The platform is built around three core workflows:

Product Matching — link your SKUs to equivalent products on competitor websites.
Price Monitoring — track competitor prices in real time and compare against your own.
Price Suggestions — define rules that automatically calculate optimal prices based on competitor data.

Platform Modules

🎁

Products

View your full catalogue with live competitor pricing and match status for every SKU.

🎚

Price Suggestions

Create global rules that calculate the best selling price using configurable strategies and markup logic.

✅

Confirmation Queue

Review and approve system-suggested product matches before they become live.

🔗

Matching Queue

Manually match unrecognised products to competitor listings one item at a time.

📊

Data Insights

Analyse portfolio overlap, price benchmarks, and brand coverage across all competitors.

⚙️

Administration

Manage users, organisations, websites, product feeds, and competitor configurations.

Key Concepts

Product Match Statuses

Every product in your catalogue carries one of the following statuses:

Status	Meaning
Matched	The product has been successfully linked to one or more competitor listings.
To Confirm	The system has found a potential match that requires human review before activation.
To Match	No match has been found yet; the product is queued for manual or automated matching.
Skipped	Matching was skipped for this product in the current cycle.
Never Match	Matching has been permanently disabled for this product.
Expired	A previously valid match is no longer available on the competitor's site.

Matching Strategies

When adding a competitor, you choose how matches are handled:

Automatic — matches identified by the system become live immediately without review.
Confirmation — all system-found matches are held in the Confirmation Queue for manual approval first.

Organisations & Websites

Coolpie.ai uses a two-level hierarchy. An Organisation is a top-level account entity (e.g. your company). Each organisation can have one or more Websites — the individual storefronts being monitored and priced. Product feeds and competitor configurations are attached at the website level.

Getting Started

Set up your Organisation and Website
Go to Organizations to create your company entity, then add your storefront under Websites.
Connect a Product Feed
Add your product data source under Product Feeds. Google Shopping Feed format is supported. The platform will regularly fetch and index your catalogue.
Add Competitors
Go to Competitors and add the URLs of the competitor stores you want to monitor. Choose a matching strategy (Automatic or Confirmation) for each.
Match Products
Once competitors are configured, use the Matching Queue to link your products to competitor listings. If you chose the Confirmation strategy, review proposals in the Confirmation Queue.
Monitor Prices
Visit the Products Dashboard to see your price position across all matched competitors in real time.
Create Price Rules (optional)
Set up automated pricing logic in Price Suggestions to receive recommended prices based on competitor data and your own margin rules.