openpricengine · REST API

API documentation

Real-time and historical prices for groceries, restaurants, electronics, energy, insurance, and property — with free API key creation and full endpoint reference.

Create API key Swagger UI MCP Server Premium

Open price engine API

The Openpricengine is a resource that provides you with real-time & historical food and groceries, electronics, restaurant and retail energy prices. The engine provides a simple set of end points that allow you to query a global database of items & prices easily. You can also make use of the Swagger UI to interact and learn more about our API. For AI agents (Cursor, Claude, and other MCP hosts), see the MCP Server documentation.

openpricengine API follows the OpenAPI v3 specifications.

OPE Swagger UI MCP Server Paid Plan

Version: 1
Developer: The openpricengine Team

Created: 27 November, 2021
Modified: 18 September, 2025

If you have any questions that are beyond the scope of this help file, Please feel free to email via support@openpricengine.com.

Authentication

The openpricengine API uses API keys to authenticate requests. You can view and manage your API keys in Portal.

Create an API key in order to send requests to the openpricengine API. To create a key you need to use your email and a API key name.

Alternatively, you can refere to the Docs page to manage keys via the endpoints

Note: This API Key is free and valid for 1 month.

Authentication Endpoints

Create New API Key

Returns a new free API Key

POST

/auth/new

Creates a new free API key for the specified email and name.

Parameters

Parameter	Type	Required	Example Value
email	String	Yes	user@example.com
api_key_name	String	Yes	My API Key

Request API Key Refresh

Request OTP for API key refresh

POST

/auth/refresh/api_key/request

Requests an OTP to refresh an API key for the specified plan.

Parameters

Parameter	Type	Required	Example Value
email	String	Yes	user@example.com
plan	String	Yes	free

Refresh API Key

Refresh API key after OTP verification

POST

/auth/refresh/api_key

Refreshes an API key using the OTP received via email.

Parameters

Parameter	Type	Required	Example Value
email	String	Yes	user@example.com
otp	String	Yes	1234
plan	String	Yes	free

API base URL

The base URL you use to interact with the openpricengine api at the current version.

Your Base URL

This base URL will be used in the API documentation request examples.

Base URL

Returns information about the openpricengine.com

GET

/api/v1

Returns basic information about the API service.

Store Database

38 countries · 179 stores tracked

Country	Stores	Flag
Argentina	Click & Foods, Jumbo, Nestlé Shop Argentina
Australia	Friendlygrocerwaverton
Belgium	Beerwulf, Yummy Bazaar EU
Bolivia	Farmacorp
Botswana	Choppies
Brazil	Bretas Atacarejo, Horti Fruti, Pao de Acucar, Zona Cerealista Online, Zona Sul, deBetti
Chile	MyCocos, RKF Life, The Wild Foods
Colombia	La Canasta Colombiana, Moonbrew, MyHuevos, Oilwell Foods, Olimpica, The Grounding Co.
Denmark	Desi Store, Rema 1000, The Coffee Collective
France	Kusmi Tea, My French Grocery
Germany	Aldi SUD, Ankerkraut, MyMuesli, Vom Fass, Wajos
Guatemala	La Torre
Hungary	BioBarát, BioTechUSA
Indonesia	Bali Direct, Green Rebel Foods, Re.juve
Ireland	Green Saffron, NearyNógs, Sheridan's Cheesemongers, Teeling Distillery
Italy	Mamma Mia Italy
Jordan	Royal Roastery
Kenya	Artcaffé Market, Cake City Kenya, Goodlife Pharmacy Kenya
Lebanon	Al Rifai, Café Younes, Click O mart
Malaysia	Super Buy
Mexico	Chedraui, HEB
Netherlands	GroceryHub, Nisarga Fresh, Pieter Pot, Tawfeer
Nigeria	HealthPlus Nigeria, Supermart.ng, The Market Food Shop, VSP Botanics
Oman	Muscat Foods
Panama	Riba Smith, Super 99
Peru	Eco Tienda Perú, Healthy Market Perú, Mercado Fit Perú, PlazaVea, Vivanda
Philippines	Bounty Fresh Market, ECHO Store, Fresh Options, Gourmet Direct, Healthy Options, Rare Food Shop, Raw Bites, Shop Suki
Poland	Kraina Herbaty
Qatar	Family Food Centre, Grand Hyper Mekaines
Romania	Camelia's Tea House, Delumani, Pretty Good Coffee, Republica BIO
South Africa	Jackson's Real Food Market, Mothercity Liquor, My African Store, Pick n Pay, Pick n Pay Liquor, Sir Fruit, Urban Ethnic Market, Wellness Warehouse, Woolworths, Yuppiechef
Spain	La Vieja Fábrica, Paleobull
Sweden	Deli Tea, Mathem
United Arab Emirates	Choithrams, Mirzam Chocolate
United Kingdom	A to Z Grocers, Abel and Cole, Africa's Finest Foods, Bean & Bean Coffee, Deliciously Ella, HG Walter, House of Malt, London Grocery, Melt Chocolates, Planet Organic, Snowdonia Cheese, Spice Kitchen, The Bottle Club, The Fine Cheese Co., Three Spirit, teapigs
United States	Art of Tea, Athletic Brewing, Atlas Coffee Club, Bokksu Market, Brightland, Burlap & Barrel, ButcherBox, Catalina Crunch, Clean Simple Eats, Daily Harvest, Dang Foods, Death Wish Coffee, Diaspora Co., Driftaway Coffee, Dutch, Fly By Jing, Four Sigmatic, G Fuel, GT's Living Foods, Graza, Gusto Grocery, Harney & Sons, Haus, Hint Water, Hiyo, Intelligentsia, Jeni's Ice Creams, Kettle & Fire, Kin Euphorics, La Colombe, Laird Superfood, LesserEvil, Liquid Death, Magic Spoon, Martie, Mary's Gone Crackers, MaryRuth Organics, Milkadamia, Mud/Wtr, Navitas Organics, Nutpods, OLIPOP, Parethenon Foods, Pathwater, Primal Kitchen, Quinn Snacks, Raaka Chocolate, Rancho Gordo, Republic of Tea, Sitka Salmon Shares, Spice House, Spindrift, Stash Tea, Stumptown Coffee, Super Market Italy, Trade Coffee, Traderjoes, Verve Coffee, Vitauthority
Yemen	Move Halal
Zimbabwe	Spar Zimbabwe, TM Pick n Pay Zimbabwe

Request example

curl -X 'GET' 'https://openpricengine.com/api/v1/stores/countries' -H 'accept: application/json' -H 'Authorization: api-key'

Example Response

The delivered price data is by default returned in a standard JSON format and can easily be reparsed in any programming language.

Example Response: See below an example of an API response that provides information about a specific shops product. The returned response has a information about the product in addition to the price and Date.

								  
          [
                  {
                    "Country": "England",
                    "Continent": "Europe",
                    "Currency": "GBP",
                    "Store": "London Grocery",
                    "Category": "Food and Groceries",
                    "Product Name": "Halal Chicken Feet 500gr",
                    "Product URL": "https://londongrocery.net/collections/chicken/products/chicken-feet",
                    "Price over time": [
                      {
                        "Date": "2023-07-20",
                        "Price": 7.9
                      }
                  ]
                }
              ]

Food & Groceries

Get stores

Get the stores availabe.

GET

/api/v1/stores

Returns a list of all the stores. No Parameters.

curl -X 'GET' 'https://openpricengine.com/api/v1/stores' -H 'accept: application/json' -H 'Authorization: api-key'

Store Information

Get Store Info

Get commercial information about a store

GET

/api/v1/store_info/

Returns commercial information about stores.

Get store countries

Get the stores available in a country

GET

/api/v1/countries_tracked

Returns a json of all countries tracked by the engine and the respective stores.

								  
         {
          "Australia": [
            "Friendly Grocerwaverton"
          ],
          "United Kingdom": [
            "London Groceries",
            "Abel and Cole",
            "Planet Organic",
            "AtoZgrocersonline"
          ],
          "United States of America": [
            "Gusto Grocery",
            "parthenon foods",
            "Supermarketitaly"
          ],
          ...
          }

Get stores tracked

Get a list of stores tracked by the engine

GET

/api/v1/stores_tracked

Returns a list of all the stores from a country.

Get store's currency

Get a json of stores and their respective currencies

GET

/api/v1/currency

Returns a json of currencies.

Get available stores by plan

GET

/api/v1/available_stores/plans

Returns a json of available stores grouped by plans

Get product names from a store

Returns a json of products from a store.
Takes in a List of strings

GET

/api/v1/stores/products/names

Parameters

Parameter	Type	Example Value
stores	List	['pnp', 'woolworths']

Python Example


  import requests

  url = 'https://openpricengine.com/api/v1/stores/products/names'
  headers = {
      'accept': 'application/json',
      'Authorization': 'api-key'
  }
  params = {
      'stores': ['pnp', 'woolworths']
  }
  
  response = requests.get(url, headers=headers, params=params)
  print(response.json())

Get product names from a store by plan

Returns a json of products from a store by plan.
Takes in a List of strings

GET

/api/v1/stores/products/names/plan

Parameters

Parameter	Type	Example Value
plan	String	free, mid, premium
stores	List	['pnp', 'woolworths']

Get todays prices

Returns a json of products and todays prices

GET

/api/v1/{STORE_NAME}/products/today?productname={PRODUCT_NAME}& currency={CURRENCY_CODE}

Returns a list of all the stores from a country.

Parameters

Parameter	Type	Example Value
store	String	woolworths
productname	String	milk
currency	String	ZAR or Deafult

Get historical prices

Returns a list[dict] of historical prices

GET

/api/v1/{STORE_NAME}/products/query?productname={PRODUCT_NAME}& range={DATE_RANGE}& currency={CURRENCY_CODE}

Returns a list of all the stores from a country.

Parameters

Parameter	Type	Example Value
store	String	woolworths
productname	String	milk
start_date	String	2024-05-25
end_date	String	2025-02-12
currency	String	USD or Default

Python Example

				
        import requests

        url = 'https://openpricengine.com/api/v1/woolworths/products/query'
        headers = {
            'accept': 'application/json',
            'Authorization': 'api-key'
        }
        params = {
            'productname': 'milk',
            'start_date': '2024-06-25',
            'end_date': '2025-06-25',
            'currency': 'Default'
        }
        
        response = requests.get(url, headers=headers, params=params)
        
        
        print(response.json())

Get prices from multiple stores

Returns a list[dict] of historical prices from multiple stores

GET

/api/v1/multiple_stores/prices/query?stores={STORE_NAMES}& productname={PRODUCT_NAME}& start_date={START_DATE}& end_date={END_DATE}& currency={CURRENCY_CODE}

Returns a list of all the stores from a country.

Parameters

Parameter	Type	Example Value
stores	list	['woolworths','London Grocer']
productname	String	milk
start_date	String	2024-05-25
end_date	String	2025-02-12
currency	String	USD or Default

Python Example

				
        import requests
        
        url = 'https://openpricengine.com/api/v1/multiple_stores/prices/query'
        headers = {
            'accept': 'application/json',
            'Authorization': 'api-key'
        }
        
        # Define the parameters
        params = {
            'stores': ['woolworths', 'London Grocer'],
            'productname': 'milk',
            'start_date': '2024-06-25',
            'end_date': '2025-06-25',
            'currency': 'Default'
        }
        
        response = requests.get(url, headers=headers, params=params)

        print(response.json())

Restaurants

Restaurant Database

Country	No. Restaurants
Australia	100
United Kingdom	181
United States of America	135
South Africa	39
Canada	228
Singapore	118
Philippines	138
India	56

Example Response

				
             [
              {
                "Country": "South Africa",
                "Continent": "Africa",
                "Currency": "ZAR",
                "Store": "mcdonalds-menu",
                "Category": "Beef",
                "Product Name": "big mac",
                "Price over time": [
                  {
                    "Date": "2024-06-30",
                    "Price": 78.4
                  }
                ]
              },
              {
                "Country": "Indonesia",
                "Continent": "Asia",
                "Currency": "IDR",
                "Store": "mcdonalds-menu",
                "Category": "A La Carte & Paket",
                "Product Name": "big mac",
                "Price over time": [
                  {
                    "Date": "2024-06-30",
                    "Price": "p37.700"
                  }
                ]
              },
              ...

Get restaurants info

Get Restaurants Info

GET

/api/v1/restaurants/info

Returns a list[dict] of restaurants tracked. No Parameters.

curl -X 'GET' 'https://openpricengine.com/api/v1/restaurants/info' -H 'accept: application/json' -H 'Authorization: api-key'

Get restaurant countries

Get the countries where restaurants are tracked

GET

/api/v1/restaurants/countries

Returns a json of countries and country codes you can use to search. No Parameters.

Get restaurant names

Returns a dict of restaurants from the queried country

GET

/api/v1/restaurants/Restaurant_names?country={COUNTRY_NAME}

Returns a json with the countries and their restaurants.

Parameters

Parameter	Type	Example Value
Country	List	['za','usa']

Python Example

				
        import requests
        
        url = 'https://openpricengine.com/api/v1/restaurants/Restaurant_names'
        headers = {
            'accept': 'application/json',
            'Authorization': 'api-key'
        }
        
        # Define the parameters
        params = {
            'country': ['za', 'usa'],
        }
        
        response = requests.get(url, headers=headers, params=params)

        print(response.json())

Get Menu items

Returns a dict with a lists of menu items from the queried restaurant

GET

/api/v1/restaurants/food_items?menu_names={RESTAURANT_NAME}&country={COUNTRY_NAME}

Returns a json with the restaurants and their food items.

Parameters

Parameter	Type	Example Value
menu_names	List	['kfc','mcdonalds']
Country	List	['za']

Example Response

				
        {
        "kfc-menu": [
          "snack burger",
          "crunch burger",
          "pops",
          "dunked pops",
          "regular chips",
          "wrapsta",
          "large pops",
          "nugget box buddy",
          "all star box with buddy bottle"
          ...
          ]
        }

Get menu item prices

Returns a dict with a lists of menu items from the queried restaurant

GET

/api/v1/restaurants/menu/items/prices?menu_names={RESTAURANT_NAME}&food_item={FOOD_ITEM}&country={COUNTRY_NAME}¤cy=Default

Returns a List[dict] with the restaurants and their food items with prices.

Parameters

Parameter	Type	Example Value
menu_names	List	['kfc']
menu_item	List	['wings','wrapsta']
Country	List	['za']
Currency	String	zar

Python Example

				
        import requests
        
        url = 'https://openpricengine.com/api/v1/restaurants/menu/items/prices'
        headers = {
            'accept': 'application/json',
            'Authorization': 'api-key'
        }
        
        # Define the parameters
        params = {
            'menu_item': ['wings','wrapsta'],
            'menu_names': ['kfc']
            'country': ['za'],
            'currency':'Default'
        }
        
        response = requests.get(url, headers=headers, params=params)

        print(response.json())

Get any food item prices

Returns a dict with a lists of food items from all restaurants

GET

api/v1/restaurants/menu/all_menus?food_item={FOOD_ITEM} & currency=Default

Returns a List[dict] with all food items queried with prices.

Parameters

Parameter	Type	Example Value
food_item	List	['burger']
Currency	String	zar

Python Example

				
        import requests
        
        url = 'https://openpricengine.com/api/v1/restaurants/menu/all_menus'
        headers = {
            'accept': 'application/json',
            'Authorization': 'api-key'
        }
        
        # Define the parameters
        params = {
            'food_item': ['burger'],
            'currency':'Default'
        }
        
        response = requests.get(url, headers=headers, params=params)

        print(response.json())

Electronics

Electronics Database

Country	No. Stores	Stores
Belgium	2	Alternate, LA Systems
Kosovo	1	AztechOnline
Switzerland	2	Interdiscount, Revendo
Slovakia	1	Nay
North Macedonia	1	Neptun
Ukraine	1	Comfy
Bulgaria	1	TechnOPolis
Netherlands	1	iBood
Bosnia	1	Ekupi
Malta	1	Digital Zone
Montenegro	1	Datika
Denmark	1	Power
Hungary	1	PCX
South Africa	1	Takealot
Austria	1	Electronic 4 You
USA	1	Costco
Serbia	1	Tehnomedia
Finland	1	Verkkokauppa
Estonia	1	Arvutitark
Italy	1	Refurbed
Belarus	1	Sila
Cyprus	1	Stephanis
Lithuania	1	Fortakes
Andorra	1	Fnac
Norway	1	Komplett
Latvia	1	Euronics

Example Response

				
             {
               "Electronics Stores": {
                 "Belgium": [
                   "Alternate",
                   "LA Systems"
                 ],
                 "Kosovo": [
                   "AztechOnline"
                 ],
                 "Switzerland": [
                   "Interdiscount",
                   "Revendo"
                 ],
                 "Slovakia": [
                   "Nay"
                 ],
                 "North Macedonia": [
                   "Neptun"
                 ],
                 "Ukraine": [
                   "Comfy"
                 ],
                 "Bulgaria": [
                   "TechnOPolis"
                 ],
                 "Netherlands": [
                   "iBood"
                 ],
                 "Bosnia": [
                   "Ekupi"
                 ],
                 "Malta": [
                   "Digital Zone"
                 ],
                 "Montenegro": [
                   "Datika"
                 ],
                 "Denmark": [
                   "Power"
                 ],
                 "Hungary": [
                   "PCX"
                 ],
                 "South Africa": [
                   "Takealot"
                 ],
                 "Austria": [
                   "Electronic 4 You"
                 ],
                 "USA": [
                   "Costco"
                 ],
                 "Serbia": [
                   "Tehnomedia"
                 ],
                 "Finland": [
                   "Verkkokauppa"
                 ],
                 "Estonia": [
                   "Arvutitark"
                 ],
                 "Italy": [
                   "Refurbed"
                 ],
                 "Belarus": [
                   "Sila"
                 ],
                 "Cyprus": [
                   "Stephanis"
                 ],
                 "Lithuania": [
                   "Fortakes"
                 ],
                 "Andorra": [
                   "Fnac"
                 ],
                 "Norway": [
                   "Komplett"
                 ],
                 "Latvia": [
                   "Euronics"
                 ]
               },
               "total_stores": 28
             }

Electronics Info

Learn about our electronics prices

GET

/api/v1/electronics/info

Returns information about available electronics data.

Electronics Stores

Get all available electronics stores

GET

/api/v1/electronics/stores

Returns a list of all available electronics stores.

Electronics Store Products

Endpoint

GET /api/v1/electronics/stores/products

Parameters

Parameter	Type	Required	Description
store	string	Yes	Name of the electronics store (e.g., "Komplett", "Costco", "Takealot")

Headers

accept: application/json
Authorization: api-key

Example Response

                              
                                   {
                                     "store": "Komplett",
                                     "products": [
                                       "3Dconnexion Spacemouse Enterprise 3D Mus",
                                       "4Smarts Stylus Pen 2in1, Sort",
                                       "4Smarts iPad Air 10,9\" / 11\" Dailybiz Foliodeksel",
                                       "4smarts 60W USB-C Ladestasjon (sort)",
                                       "4smarts DailyBiz BT iOS Keyboard"
                                     ]
                                   }

Example Request

import requests

url = "https://openpricengine.com/api/v1/electronics/stores/products"
params = {"store": "Komplett"}
headers = {
    "accept": "application/json",
    "Authorization": "api-key"
}

response = requests.get(url, params=params, headers=headers)
data = response.json()

print(data)

Get Electronics Product Prices

Endpoint

GET /api/v1/electronics/products/prices

Parameters

Parameter	Type	Required	Description
store	string	Yes	Name of the electronics store (e.g., "Takealot", "Komplett", "Costco")
product	string	Yes	Product category or search term (can be used multiple times)

Example Response

                              
                                  [
                                    {
                                      "Country": "South Africa",
                                      "Continent": "Africa",
                                      "Category": "Electronics",
                                      "Currency": "ZAR",
                                      "Store": "Takealot",
                                      "Image_URL": "https://media.takealot.com/covers_images/f087b9d16fbf4b85bdfd53d8b05b795d/s-fb.file",
                                      "URL": "https://www.takealot.com/xiaomi-redmi-a3x-smartphone-midnight-black-3gb-ram-64gb/PLID96904551",
                                      "Product_Name": "Xiaomi Redmi A3x Smartphone - Midnight Black (3GB RAM + 64GB)",
                                      "Price": [
                                        {
                                          "2025-08-28": "1399.0"
                                        },
                                        {
                                          "2025-08-24": "R 1,399"
                                        }
                                      ]
                                    },
                                    {
                                      "Country": "South Africa",
                                      "Continent": "Africa",
                                      "Category": "Electronics",
                                      "Currency": "ZAR",
                                      "Store": "Takealot",
                                      "Image_URL": "https://media.takealot.com/covers_images/7328e46273e9421e92101a08a152f087/s-fb.file",
                                      "URL": "https://www.takealot.com/omega-32-hd-ready-non-smart-led-tv-hdmi-usb-av-made-in-south-afr/PLID52124242",
                                      "Product_Name": "Omega 32\" HD Ready Non-Smart LED TV HDMI/USB/AV Made in South Africa",
                                      "Price": [
                                        {
                                          "2025-08-28": "1377.0"
                                        },
                                        {
                                          "2025-08-24": "R 1,397"
                                        }
                                      ]
                                    }
                                  ]

Example Request

import requests

url = "https://openpricengine.com/api/v1/electronics/products/prices"
params = {
    "store": "takealot",
    "product": ["phone", "tv"]
}
headers = {
    "accept": "application/json",
    "Authorization": "api-key"
}

response = requests.get(url, params=params, headers=headers)
data = response.json()

print(data)

Retail Energy

Energy Sources

Learn about our retail energy prices

GET

/api/v1/energy/info

Returns information about available energy data sources.

Energy Database

Country	Currency
South Africa	ZAR
Zimbabwe	ZWL
Nigeria	NGN
Egypt	EGP
Kenya	KES
Morocco	MAD
Ghana	GHS
Australia	AUD
New Zealand	NZD
Fiji	FJD
Papua New Guinea	PGK
Solomon Islands	SBD
China	CNY
India	INR
Tunisia	TND
Japan	JPY
South Korea	KRW
Indonesia	IDR
Germany	EUR
France	EUR
United Kingdom	GBP
Italy	EUR
Spain	EUR
Netherlands	EUR
Sweden	SEK
Belgium	EUR
USA	USD
Canada	CAD
Mexico	MXN
Cuba	CUP
Guatemala	GTQ
Brazil	BRL
Argentina	ARS
Chile	CLP
Colombia	COP
Peru	PEN

Example Response

				
        {
          "source": "https://www.globalpetrolprices.com",
          "description": "This JSON provides information about energy prices for various countries.",
          "data_available": {
            "countries": [
              "South Africa",
              "Zimbabwe",
              "Nigeria",
              ...
              "Indonesia",
              "Germany",
              "France",
              "United Kingdom",
              "Italy",
              "Spain",
              "Netherlands",
              "Sweden",
              "Belgium",
              "USA"
            ],
            "energy_types": [
              "electricity",
              "gasoline",
              "natural gas"
            ],
            "years_available": [
              2024
            ],
            "months_available": [
              "July 2024"
            ]
          }
        }

Get energy prices

Returns a dict of countries queried and their energy prices

GET

api/v1/energy/search?countries={COUNTRY_NAME}& year={YEAR}& month={MONTH}

Returns a dict with energy prices.

Parameters

Parameter	Type	Example Value
countries	String	south africa
year	String	2024
month	String	July

Python Example

				
        import requests
        
        url = 'https://openpricengine.com/api/v1/energy/search'
        headers = {
            'accept': 'application/json',
            'Authorization': 'api-key'
        }
        
        # Define the parameters
        params = {
            'countries':'south africa',
            'year': '2024',
            'month':'July'
        }
        
        response = requests.get(url, headers=headers, params=params)

        print(response.json())

Yearly Insurance Prices

Get Insurance Info

Get all available insurance information

GET

/api/v1/insurance/info

Returns information about available insurance data.

Get Insurance Companies

Get insurance companies from a country

GET

/api/v1/insurance/companies

Returns a list of insurance companies.

Parameters

Parameter	Type	Required	Example Value
countries	Array of strings	No	["south africa", "usa"]

Get Insurance Companies Prices

Get insurance prices from companies

GET

/api/v1/insurance/companies/prices

Returns insurance prices from specified companies.

Parameters

Parameter	Type	Required	Default	Example Value
countries	Array of strings	No	-	["south africa"]
companies	Array of strings	No	-	["discovery", "momentum"]
insurance_type	String	No	Health Insurance	Health Insurance
year	String	No	2025	2025

High-end Property Market Data

Get Available Regions Info

Get property information

GET

/api/v1/region/info

Returns information about available property regions.

Get Available Regions

Get property regions based on search

GET

/api/v1/region/finder

Returns property regions matching the search criteria.

Parameters

Parameter	Type	Required	Example Value
area_search	String	No	sandton

Get Region Price

Get region prices, you can search by suburb, city, region, or province

GET

/api/v1/region/data

Returns property prices for the specified region.

Parameters

Parameter	Type	Required	Default	Example Value
area_search	String	No	-	sandton
features	String	No	False	False

Possible HTTP response status codes

This is a dictionary of some of the possible HTTP responses you can get when interacting with the engine.

200 Ok - Successful response
204 No Content - There is no content to send for this request, but the headers may be useful. The user agent may update its cached headers for this resource with the new ones.
300 Multiple Choices - The request has more than one possible response. The user agent or user should choose one of them. (There is no standardized way of choosing one of the responses, but HTML links to the possibilities are recommended so the user can pick.)
301 Moved Permanently - The URL of the requested resource has been changed permanently. The new URL is given in the response.
302 Found - This response code means that the URI of requested resource has been changed temporarily. Further changes in the URI might be made in the future. Therefore, this same URI should be used by the client in future requests.
303 See Other - The server sent this response to direct the client to get the requested resource at another URI with a GET request.
400 Bad Request - The server could not understand the request due to invalid syntax.
401 Unauthorized - The server could not understand the request due to invalid syntax.
402 Payment Required - This response code is reserved for future use. The initial aim for creating this code was using it for digital payment systems, however this status code is used very rarely and no standard convention exists.
403 Forbidden - The client does not have access rights to the content; that is, it is unauthorized, so the server is refusing to give the requested resource. Unlike 401 Unauthorized, the client's identity is known to the server.
404 Not Found - The server can not find the requested resource. In the browser, this means the URL is not recognized. In an API, this can also mean that the endpoint is valid but the resource itself does not exist. Servers may also send this response instead of 403 Forbidden to hide the existence of a resource from an unauthorized client. This response code is probably the most well known due to its frequent occurrence on the web.
405 Method Not Allowed - The request method is known by the server but is not supported by the target resource. For example, an API may not allow calling DELETE to remove a resource.
406 Not Acceptable - This response is sent when the web server, after performing server-driven content negotiation, doesn't find any content that conforms to the criteria given by the user agent.
414 URI Too LongThe URI requested by the client is longer than the server is willing to interpret.
422 Unprocessable EntityThe request was well-formed but was unable to be followed due to semantic errors.
429 Too Many RequestsThe user has sent too many requests in a given amount of time ("rate limiting").
500 Internal Server ErrorThe server has encountered a situation it does not know how to handle.
501 Not ImplementedThe request method is not supported by the server and cannot be handled. The only methods that servers are required to support (and therefore that must not return this code) are GET and HEAD.
502 Bad GatewayThis error response means that the server, while working as a gateway to get a response needed to handle the request, got an invalid response.

FAQ

A FAQ is a list of frequently asked questions (FAQs) and answers on a particular topic.

How long is the price date range?

Its difficult to say the exact range of price data we have. Some stores we have only recently started tracking, some we have over 8 months of data and other prices such as fuel we have over 10 years of data. Some stores we have lost the ability to track due to changes in their website structure. However, we are constantly adding new stores and products to our database. and doing our best to keep the data as structured as possible.

Is the API secure?

At this point all our data is free and accessible by anyone and there are no post requests made to our api that are a priority for us to secure.

What are some of the features to be implemented in the next version?

In the next version v2, we plan to increase the number of products as well as shops we track.

Is this API legal?

We publish this data strictly for the purpose of education, marketing and information. Our API cannot be used to harm any users or institutions which we collect this data from. Our API has no ability to influence the functionality of any website, application or outlet we recieve the data from.

Who owns and develops this API?

This API is currently owned and liscensed by the openpricengine team based in Africa.

Support

This API is now owned by ToofourproductsZA based in Southren Africa. All prices will be maintained and updated daily by our team of open source contributors.

Note: While we aim to provide the best support possible, please keep in mind that we run a small but talented team with limited resources.

Changelog

See what's new added, changed, fixed, improved or updated in the latest versions.

Version 1.0 (01 Sept, 2025)

Added https secure payment gateway
Added New API endpoints
Fixed Some minor bugs for browser compatibility
Added Restaurants
Added Energy
Updated New database attributes
Fixed Some minor bugs for responsive
Updated User interface

Version 2 (01 December, 2026)

Planned Release