API Documentation
Welcome to the Pricium developer documentation. Integrate real-time storefront search aggregation and product scraping into your application using simple HTTP requests.
Authentication
Pricium secures endpoint requests using API keys. Include your API key inside the X-API-Key HTTP header for all requests. Manage or retrieve your live API key securely through the Dashboard.
Security Warning: Never expose your live credentials in client-side client applications or public code repositories. If compromised, revoke and rotate keys immediately inside the dashboard.
Search API
Search major retail domains matching a text query to return a list of product summaries, prices, ratings, sponsored badges, and available filters.
https://api.pricium.store/searchQuery Parameters
| Parameter | Type | Status | Description |
|---|---|---|---|
| q | string | required | Search keyword or phrase, e.g. iphone 15 |
| domain | string | required | Target e-commerce store (e.g. amazon.in or flipkart.com) |
| page | integer | optional | Results page number (1-10, defaults to 1) |
| brand | string | optional | Filter by brand (comma-separated, case-insensitive) |
| price_min | float | optional | Minimum price filter |
| price_max | float | optional | Maximum price filter |
| rating_min | float | optional | Minimum rating threshold (1.0 to 5.0) |
curl -X GET "https://api.pricium.store/search?q=iphone+15&domain=amazon.in&page=1" \
-H "X-API-Key: pk_live_YOUR_API_KEY"Product Detail API
Extract structured, granular product information, seller ratings, reviews, specifications, location-aware PIN pricing, and variation configurations directly from storefront details pages.
https://api.pricium.store/product-detailRequest Query Parameters
| Field | Type | Status | Description |
|---|---|---|---|
| url | string | required | Full product page URL (e.g. starting with http:// or https://) |
| latitude | float | optional | Caller latitude. Paired with longitude for geo-aware local pricing. |
| longitude | float | optional | Caller longitude for geo-aware local pricing. |
| variations | boolean | optional | Fetch variants (size, color, etc). Defaults to true. |
| product_info | boolean | optional | Fetch key features, images, specifications. Defaults to true. |
curl "https://api.pricium.store/product-detail?url=https://www.amazon.in/dp/B0CHX1W1XY&variations=true&product_info=true" \
-H "X-API-Key: pk_live_YOUR_API_KEY"Supported Domains
Integrate real-time pricing and stock data from stable and beta e-commerce domains.
Rate Limits & Pricing
Each workspace plan specifies requests-per-minute (RPM) rate limits. Standard workspaces receive a 429 Too Many Requests HTTP code if limits are exceeded.
| Workspace Tier | Requests / min | Credits / month |
|---|---|---|
| Free Tier | 10 RPM | 500 credits |
| Starter Tier | 60 RPM | 10,000 credits |
| Pro Tier | 300 RPM | 100,000 credits |
| Enterprise | Unlimited | Custom quota |