Market Data API
Access comprehensive market and product data across multiple franchises with our RESTful API.
Multiple Franchises
Query data from different franchise networks
Flexible Search
Search and filter products by various criteria
Structured Data
Well-organized product categories and market info
Base URL
https://provericeni.com/api/v0/{endpoint}
Response Format
Content-Type: application/json
Authentication
x-api-key
request header.
Header Example
GET /api/v0/franchises x-api-key: YOUR_API_KEY_HERE
How to Get an API Key
You get one when you make an account. You can copy it in the dashboard. To get more calls per month contact us to get on a plan.
Error Responses
401 Unauthorized{ "error": "Missing API key." }
{ "error": "Invalid API key." }
{ "error": "API call limit exceeded." }
Retrieve a list of all available franchises.
x-api-key
header.
Parameters
This endpoint does not require any parameters.
Example Request
curl -X GET "https://provericeni.com/api/v0/franchises" \ -H "x-api-key: YOUR_API_KEY_HERE"
Response
200 OK[ "kam", "ramstore", "vero", ... ]
List all markets in one or all franchises.
x-api-key
header.
Query Parameters
Parameter | Type | Required | Description |
---|---|---|---|
franchise |
string | Optional | Specific franchise to search in. If left blank, all franchises will be searched. |
Example Request
curl -X GET "https://provericeni.com/api/v0/markets?franchise=ramstore" \ -H "x-api-key: YOUR_API_KEY_HERE"
Response
200 OK[ { "franchise": "ramstore", "id": "45610510", "name": "ramstore-aerodrom", "address": "UL.MILAN ZECHAR BR.6 AERODROM, SKOPJE", "url": "https://ramstore.com.mk/marketi/ramstore-aerodrom/" }, { "franchise": "ramstore", "id": "02502275", "name": "ramstore-debar-maalo", "address": "UL.BLAGOJ DAVKOV BR.2 CENTAR,SKOPJE", "url": "https://ramstore.com.mk/marketi/ramstore-debar-maalo/" }, ... ]
Search through a specific franchise and return filtered products from a matching market.
x-api-key
header.
Query Parameters
Parameter | Type | Required | Description |
---|---|---|---|
franchise |
string | Required | Franchise folder to search in (e.g., "ramstore") |
marketId |
string | Optional* | Find market by market ID |
marketName |
string | Optional* | Find market by market name (exact match) |
subgroup |
string | Optional | Filter products by subgroup name. Subgroups are created by grouping products by keywords in their names. |
nameContains |
string | Optional | Filter products whose name includes this text (case-insensitive) |
limit |
number | Optional | Limit number of products returned. If omitted or 0, return all |
categorizedProducts |
boolean | Optional | If true, products are grouped by their subgroup |
* Either marketId or marketName is required
Example Requests
Get products by market ID:
curl -X GET "https://provericeni.com/api/v0/market-products?franchise=ramstore&marketId=90657548" \ -H "x-api-key: YOUR_API_KEY_HERE"
Get products with filters:
curl -X GET "https://provericeni.com/api/v0/market-products?franchise=franchise2&marketName=ramstore-karposh&subgroup=TESTENINI_OSNOVI_ORIZ&limit=50" \ -H "x-api-key: YOUR_API_KEY_HERE"
Get categorized products:
curl -X GET "https://provericeni.com/api/v0/market-products?franchise=ramstore&marketName=ramstore-karposh&categorizedProducts=true" \ -H "x-api-key: YOUR_API_KEY_HERE"
Response
200 OK{ "market": "RAMSTORE", "market_name": "ramstore-karposh", "market_address": "UL. PRASHKA BR.11-2/ LOK.1234567 KARPOSH, SKOPJE", "market_url": "https://ramstore.com.mk/marketi/ramstore-karposh/", "market_id": "86332579", "categories": [ { "subgroup": "TESTENINI_OSNOVI_ORIZ", "products": [ { "name": "SONCHEVA DOLINA ORIZ 900 GR", "price": "155.00" // Macedonian Denar }, ... }, { "subgroup": "PAVLAKI", "products": [ { "name": "VAT SNEK SO PAVLAKA KROMID 50 GR", "price": "52.00" }, ... }, ] }
Error Responses
400 Bad Request{ "error": "Missing required parameter: franchise and (marketId or marketName)." }
{ "error": "Market not found in this franchise." }
Search all franchises and markets for products matching a name substring.
x-api-key
header.
Query Parameters
Parameter | Type | Required | Description |
---|---|---|---|
searchString |
string | Required | Case-insensitive substring to search for in product names |
Example Request
curl -X GET "https://provericeni.com/api/v0/search-products?searchString=oriz" \ -H "x-api-key: YOUR_API_KEY_HERE"
Response
200 OK[ { "franchise": "stokomak", "market_name": "TAFTALIDZHE", "product": { "name": "ITALIJANSKI ORIZ DOLGO ZRNO 1KGR", "price": "115 DEN.", "subgroup": "TESTENINI_OSNOVI_ORIZ" } }, { "franchise": "stokomak", "market_name": "MLECHEN", "product": { "name": "CHORIZO EKSTRA 100 GR KOSTA BRAVA", "price": "89 DEN.", "subgroup": "TESTENINI_OSNOVI_ORIZ" } }, ]
Error Responses
400 Bad Request{ "error": "Missing required parameter: searchString" }
Market API Documentation - Built with <3 for developers