Price Tracking

Price-tracking subscriptions are deprecated for new integrations — use product subscriptions instead of start/stop tracking. Price tracking still works and is still billed at 1 credit/product/day (see pricing). Price history is not deprecated — it remains the supported way to fetch historical prices.

Channel3 refreshes tens of millions of products daily and records their price history. With the Price Tracking API, you can subscribe to any product and receive a webhook the moment its price changes — the foundation of a deal finder or “time-to-buy” UX.

Start tracking a product

Subscribe to price change notifications by calling the start-tracking endpoint with a canonical product_id (any ID from a search or lookup result).

import Channel3 from "@channel3/sdk";

const client = new Channel3();

await client.priceTracking.start({
  canonical_product_id: "2yh8WH5",
});

console.log("Now tracking price changes for product 2yh8WH5");

from channel3_sdk import Channel3

client = Channel3()

client.price_tracking.start(canonical_product_id="2yh8WH5")
print("Now tracking price changes for product 2yh8WH5")

curl -X POST https://api.trychannel3.com/v0/price-tracking/start \
  -H "x-api-key: $CHANNEL3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"canonical_product_id": "2yh8WH5"}'

Stop tracking

await client.priceTracking.stop({ canonical_product_id: "2yh8WH5" });

client.price_tracking.stop(canonical_product_id="2yh8WH5")

Fetch price history

Once a product is tracked, retrieve its full price history for a “time-to-buy” chart. History accumulates from the moment you start tracking, and also pulls from Channel3’s existing historical data where available.

const history = await client.priceTracking.getHistory({
  canonical_product_id: "2yh8WH5",
});

for (const point of history.price_history) {
  console.log(point.timestamp, point.price, point.currency);
}

history = client.price_tracking.get_history(canonical_product_id="2yh8WH5")

for point in history.price_history:
    print(point.timestamp, point.price, point.currency)

curl "https://api.trychannel3.com/v0/price-tracking/history/2yh8WH5" \
  -H "x-api-key: $CHANNEL3_API_KEY"

List your subscriptions

See all products you’re currently tracking:

const subs = await client.priceTracking.listSubscriptions();
console.log(subs.subscriptions.map(s => s.canonical_product_id));

subs = client.price_tracking.list_subscriptions()
print([s.canonical_product_id for s in subs.subscriptions])

Webhooks

Configure a webhook endpoint in the Channel3 dashboard to receive real-time notifications whenever a tracked product’s price changes. Channel3 sends a POST request to your endpoint with the product ID and new price. Verify the signature on every request — see Verifying signatures.

Price Tracking Webhooks

Full payload schema for the price.changed event.

Product Subscription Webhooks

Availability changes, offers appearing and going away, and domain- or variant-scoped subscriptions.

Example webhook handler (Next.js)

TypeScript

// app/api/price-webhook/route.ts
import { NextRequest, NextResponse } from "next/server";

export async function POST(req: NextRequest) {
  const event = await req.json();

  if (event.type === "price.changed") {
    const { canonical_product_id, new_price, currency } = event;
    // Notify users who saved this product, update your UI, etc.
    await notifyUsers(canonical_product_id, new_price, currency);
  }

  return NextResponse.json({ received: true });
}

Build a deal finder

The highest-converting shopping experience you can build is a deal finder. Here’s the full pattern:

When a user saves or views a product, call priceTracking.start to subscribe.
Display the price history chart using the price-chart UI component or GET /v0/price-tracking/history/{id}.
When Channel3 fires a webhook, push a notification to your user.

// 1. User saves a product
async function onProductSave(productId: string) {
  await channel3Client.priceTracking.start({ canonical_product_id: productId });
}

// 2. On the product page, load price history
async function loadPriceHistory(productId: string) {
  return channel3Client.priceTracking.getHistory({ canonical_product_id: productId });
}

// 3. Webhook fires → notify the user
// (see webhook handler above)

# 1. User saves a product
def on_product_save(product_id: str):
    client.price_tracking.start(canonical_product_id=product_id)

# 2. On the product page, load price history
def load_price_history(product_id: str):
    return client.price_tracking.get_history(canonical_product_id=product_id)

Price history UI component

Don’t want to build the chart yourself? The Channel3 UI library ships a price-chart component:

npx shadcn@latest add https://ui.trychannel3.com/r/all.json

import { PriceChart } from "@/components/channel3/price-chart";

<PriceChart
  history={priceHistory.price_history}
  currentPrice={product.offers[0].price}
/>

UI + Hooks

The full component library — search, PDP, price charts, and headless hooks.

Getting Started

Make a Search

Get Product Data

Conversational Agent

Checkout

Pricing, Reporting, and Commissions

Build

Integrate

FAQ

Start tracking a product

Stop tracking

Fetch price history

List your subscriptions

Webhooks

Price Tracking Webhooks

Product Subscription Webhooks

Example webhook handler (Next.js)

Build a deal finder

Price history UI component

UI + Hooks

​Start tracking a product

​Stop tracking

​Fetch price history

​List your subscriptions

​Webhooks

Price Tracking Webhooks

Product Subscription Webhooks

​Example webhook handler (Next.js)

​Build a deal finder

​Price history UI component

UI + Hooks

Start tracking a product

Stop tracking

Fetch price history

List your subscriptions

Webhooks

Example webhook handler (Next.js)

Build a deal finder

Price history UI component