Bidvoy API documentation & discussions
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
endpoints Fixed a typo Apr 25, 2015 Updated API documentation Nov 1, 2015

Bidvoy API

Welcome great developer!

On the following pages you can find documentation and resources of the bidvoy API. Every application out there helps us to make bidvoy more awesome. So, if you are programming based on our RESTful API feel free to contact us anytime. We are really looking forward to your feedback in order to extend the API here and make it better. We really love to here from your project!

Get started

The first step is always the hardest.. but not here. We designed our API in a way that it is easy to understand and simply to handle. No one wants to read pages of text before getting started. That's why we present you a short overview of our endpoints together with a sample call for each method to make it more concrete.

API token

Right now our API is kind of a beta version. That means that you need a token to authorize your application and are allowed to make calls. How do you get such a key? Easy as pie. Just drop us a line ( containing the following information:

  • Where do you want to use it? (domain)
  • What do you want to do? (a short description is fine)

After we have approved your request, you get your personal API token and you can start immediately. Again the whole procedure is because of the beta state of our API. We promise that everything gets easier later.


All of your API related feedback, suggestions or bug reports can and should be filed in this github repository as an issue.





Article (Deprecated in favor of Analysis endpoint)



  • Fixed an encoding problem with link output of analysis/statistics


  • All endpoints support the country Austria now
  • category/searchbyname enpoint was removed
  • category/searchbykeyword Response field "parent" renamed to "parentid"
  • article/analyse endpoint was renamed to analysis/statistics; article/analyse stays functional for a while, however we strongly suggest to update
  • analysis/statistics Request parameter "quickdate" added
  • analysis/statistics Response field "currency" contains now ISO 4217 code instead of currency symbol
  • all endpoints: Response field "dataCount" removed
  • all endpoints: Response field "status" contains now HTTP status codes instead of "OK/FAIL"


  • article/analyse Request parameter "startdate" and "enddate" added


  • account/usage Response field "dailyLimit" removed, "monthlyLimit" added


  • Initial release