Quickstart

You need an API key in AGGREFINE_API_KEY.

Find your channel

The API serves one channel at a time, so start by listing yours:

curl https://api.aggrefine.com/v0/channels -H "Authorization: Bearer $AGGREFINE_API_KEY"

[{ "id": "8f1c…", "name": "Dog Food Reviews", "kind": "website", "url": "https://example.com/" }]

export CHANNEL_ID=8f1c…

Browse its products

curl "https://api.aggrefine.com/v0/channels/$CHANNEL_ID/products?limit=5" \
  -H "Authorization: Bearer $AGGREFINE_API_KEY"

You get a page of products in items, each with its offers, and a next_cursor for the next page.

Get one product

Pick a gtin from the list, or use the barcode on a package:

curl https://api.aggrefine.com/v0/channels/$CHANNEL_ID/products/07318690000016 \
  -H "Authorization: Bearer $AGGREFINE_API_KEY"

The response lists every shop selling it, with price, stock and your affiliate_url. Link to that URL and the commission is yours.

Next steps

A “where to buy” box for one product.

The cheapest shop for each product on a page.

Page through the catalog for products on sale.