Grocerybear - gathering global grocery pricing information

Market insights delivered

Grocerybear is a brokerage for market intelligence. We believe that there is a significant disconnect between commodity level pricing available to traders on Wall Street and actual underlying market fundamentals. We seek to bridge this gap by providing data that reflects the on the ground experience of real humans.

We offer a comprehensive application programming interface (API) so that you can programatically obtain our data and automatically implement it in your proprietary trading, risk, and supply chain models.

We currently support 16 cities for which we have thousands of product prices, updated daily. We are in a beta stage and only provide access to our free tier API, which allows programatic queries against all cities for three key food categories: eggs, bread, and milk.

We are working hard to deploy our full API which will be available to premium users and will enable access to the entirety of our rich, multi-facted, data stream.

API

Tiered

We offer free and premium API access to our global data feed.

What you need

You can easily parameterize API calls to return just what you need.

Up to Date

We also offer live charts on our basic data feed.

Rapid Support

Need an additional city or product? Hit us up!

Sign up

Currently, we are offering early users access to the free tier of our API. Stay tuned for the release of our full, premium global grocery price API! In the meantime, sign-up for our free tier below and let us know what you think.

API Documentation

The Grocerybear basic API is extremely easy to use. As we continue to enhance our offering we will add additional premium endpoints. For the time being, there is only one endpoint available to users: https://grocerybear.com/getitems.

The /getitems endpoint lets you query our rich database of grocery prices and pull prices for either eggs, milk, or bread from our selected cities:


                [Full city name in brackets; use abbreviation in API call]
                all [returns all cities]
                Abuja
                Austin
                Boise
                DC [Washington DC]
                Honolulu
                Houston
                LA [Los Angeles]
                LV [Las Vegas]
                Mumbai
                New York
                Orlando
                Phoenix
                Portland
                Seattle
                SF [San Francisco]
                Shanghai
                We are actively adding new cities and countries.

Also, you can specify the number of days (num_days) you wish to return. This is an integer looking back from today. For example, if you pass num_days: 5 you will return the last five days of the product you have selected. If you set num_days to 0 we will return you all the data we have available for the given city and product combination.

Here is a sample API call:


                    curl -H "api-key: your-api-key" \
                         -H "Content-Type: application/json" \
                         -X POST \
                         -d '{"city":"Austin", "product":"eggs", "num_days": 7}' \
                         https://grocerybear.com/getitems

Note that this API requires authentification. The api-key which was emailed to you after registration should be inserted into the above curl command instead of 'your-api-key'. For example if your api-key is 123ABC and you would like to query New York for the last 10 days of bread prices you would submit the following request:


                    curl -H "api-key: 123ABC" \
                         -H "Content-Type: application/json" \
                         -X POST \
                         -d '{"city":"New York", "product":"bread", "num_days": 10}' \
                         https://grocerybear.com/getitems

The response payload is returned in standard JSON as shown below. Note that when relevant the product price has been converted to USD using open exchange rates. Also, note that the date format is yy-mm-dd.

                    [
                      {
                        "city": "LA",
                        "date": "17-02-26",
                        "price": 1.99,
                        "title": "Signature Kitchens 100% Whole Wheat Bread - 22 Oz"
                      },
                      {
                        "city": "LA",
                        "date": "17-02-27",
                        "price": 1.99,
                        "title": "Signature Kitchens 100% Whole Wheat Bread - 22 Oz"
                      }
                    ]

If you have any questions about the API please, contact us! We'd love to hear from you.