Developer Portal

Build, automate, embed.

Integrate Nesika’s powerful matching engine directly into your workflows with our simple, robust API.

curl -H "X-API-Key: nes_your_key_here" \
  "https://api.nesika.ai/api/v1/products/search?q=iPhone+16&vendorId=kogan"

Quick Start

// Search for competitor prices (public — no key needed)
fetch('https://api.nesika.ai/api/v1/products/search?q=iPhone+16&vendorId=kogan')
  .then(res => res.json())
  .then(data => console.log(data));

// Access your workspace products (requires API key)
fetch('https://api.nesika.ai/api/v1/me/products', {
  headers: { 'Authorization': 'Bearer YOUR_NESIKA_API_KEY' }
})
  .then(res => res.json())
  .then(data => console.log(data));

Product Search

Search the public product catalog across vendors. No authentication required.

GET/api/v1/products/search

Parameter	Type	Description
q*	string	Search query (min 2 chars). Product name, barcode, or category.
vendorId	string	Filter by vendor ID (e.g. kogan, bigw, bunnings).
category	string	Filter by product category.
page	integer	Page number (default: 1).
pageSize	integer	Results per page (max 100, default: 20).

curl "https://api.nesika.ai/api/v1/products/search?q=iPhone+16&vendorId=kogan&pageSize=5"

Price Comparison

Compare prices for a single product across all vendors in the catalog.

GET/api/v1/products/{productId}/prices

Parameter	Type	Description
productId*	string	Product ID from search results.

curl "https://api.nesika.ai/api/v1/products/prod_abc123/prices"

Price History

Retrieve historical price time-series for a product, bucketed by competitor and granularity.

GET/api/v1/products/{productId}/price-history-series

Parameter	Type	Description
productId*	string	Product ID.
from	date	Start date (YYYY-MM-DD). Default: 90 days ago.
to	date	End date (YYYY-MM-DD). Default: today.
granularity	string	daily \| weekly \| monthly (default: daily).
competitorIds	string[]	Comma-separated competitor IDs to filter.

curl "https://api.nesika.ai/api/v1/products/prod_abc123/price-history-series?granularity=weekly&from=2025-01-01"

Market Insights

Aggregate market statistics for a product category — average price, median, range, distribution, and trend.

GET/api/v1/insights/market

Parameter	Type	Description
category*	string	Product category or vendor partition key.

curl "https://api.nesika.ai/api/v1/insights/market?category=electronics"

My Products 🔑 API Key required

List your workspace's tracked products with current prices, scan status, and competitor counts. Requires an Authorization: Bearer header with your API key.

GET/api/v1/me/products

Parameter	Type	Description
query	string	Search within your tracked products.
page	integer	Page number (default: 1).
pageSize	integer	Results per page (max 100).
status	string	tracked \| all (default: tracked).

curl -H "Authorization: Bearer YOUR_NESIKA_API_KEY" \
  "https://api.nesika.ai/api/v1/me/products?pageSize=20"

Other authenticated endpoints: /api/v1/me/products/{id}/position, /api/v1/me/scans, /api/v1/me/price-changes, /api/v1/me/insights/summary