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

API key required. All endpoints require authentication via API key passed in the 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."
}
403 Forbidden
{
    "error": "Invalid API key."
}
429 Too Many Requests
{
    "error": "API call limit exceeded."
}
GET /franchises

Retrieve a list of all available franchises.

Requires a valid API key in the 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",
    ...
]
GET /markets

List all markets in one or all franchises.

Requires a valid API key in the 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/"
    },
    ...
]
GET /market-products

Search through a specific franchise and return filtered products from a matching market.

Requires a valid API key in the 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)."
}
404 Not Found
{
    "error": "Market not found in this franchise."
}

Market API Documentation - Built with <3 for developers