# 3CHEAPS

> Romanian price comparison platform. Compare product prices across 1,500+ online shops with live price updates.

3CHEAPS helps users find the lowest price for electronics, home appliances, books, and more. Each product has a stable public ID and canonical URL.

## Docs

- Full documentation: /llms-full.md
- Bot policy: /bot
- Contact: /contact

## Public JSON APIs

All endpoints return JSON. Base URL: https://3cheaps.com

- Search products: GET /api/products-search.php?q={query}&page=1&limit=24
- Category products: GET /api/products-search.php?categoryId={id}&page=1
- Product details: GET /api/products-get.php?id={publicProductId}
- Live prices: GET /api/live-prices.php?productId={publicProductId}&country=ro
- Live prices (SSE): GET /api/live-prices-stream.php?productId={publicProductId}&country=ro
- Departments: GET /api/departments.php
- Categories by department: GET /api/categories.php?department={sef_name}
- Category by id: GET /api/categories.php?id={categoryId}
- Shops list: GET /api/shops.php
- Shop details: GET /api/shops.php?seller={seller}
- Resolve shop URL: GET /api/resolve-url.php?url={encodedShopProductUrl}

## URL patterns

- Product page: /{slug}/p/{publicProductId}
- Category listing: /{category-sef}-{categoryId}/c
- Search: /search-0/c?search={query}
- Department: /{department}/d
- Shop page: /magazin-{seller}
- Shop directory: /magazine

## Crawling

- XML sitemaps: /sitemaps/sitemap.xml
- Prefer the JSON APIs above instead of scraping HTML product pages

## MCP

Model Context Protocol server in /mcp-server/ for AI agents. Requires `THREECHEAPS_API_KEY` for unlimited API access.

## Rate limits

APIs are limited per IP (e.g. 30 catalog requests/hour). See /llms-full.md for details.