MyFitnessPal calories available via Health Graph API

A quick note for all Health Graph platform (@healthgraphapi) partners:

RunKeeper‘s (@runkeeper) recently announced integration with MyFitnessPal enables users to connect their accounts on the two systems to automatically sync MyFitnessPal tracked calories consumed (i.e. calories added) into RunKeeper while also syncing RunKeeper tracked fitness activities (calories subtracted) into MyFitnessPal. Weight measurements are also synchronized bidirectionally between the two systems so that your latest weight is consistent between the two.

MyFitnessPal calories consumed displayed in RunKeeper fitness feed

But there’s an added bonus for other RunKeeper partners and members of the Health Graph community. Both calories consumed and weight measurements synchronized from MyFitnessPal to RunKeeper are available to all Health Graph API developers. Calories appear as Nutrition sets with values in the calories field and weight measurements appear in Weight sets. Both of these nutrition and weight sets will have a source value of ‘MyFitnessPal‘ to indicate their origin.

We hope that access to the additional MyFitnessPal-originated data will help you build even more amazing things for our collective user community!

Bill Day (@billday) is Platform Evangelist & PM for RunKeeper where he helps developers learn about and use the Health Graph platform.


Lose weight faster with DietBet and your friends

DietBet (@dietbet) enables runners and other RunKeeper (@runkeeper) users to lose weight socially by challenging their friends to a fun weight loss competition. Below we discuss how DietBet uses the Health Graph API & platform (@healthgraphapi) to help motivate people and keep their weight loss journeys fun.

Bill Day: Please tell us about yourself and your work.

Adam McClean of DietBet

Adam McClean: I’ve been a product manager for almost eight years with a primary focus in e-commerce and consumer brands. I’m also training for a mini marathon later this year.

BD: What is the “elevator pitch” for why someone should use DietBet?

AM: DietBet is the best way to jumpstart your weight loss and access the support necessary for success. It’s a great mix of behavioral economics (loss aversion and financial incentives), community, and accountability. Players put money on the line and commit to losing 4% of their starting weight in 4 weeks. During the game players make friends, talk smack, and track their progress as they approach their goal. Everyone who reaches the 4% goal ends up splitting the pot — and making some extra money!

BD: How did you get started using the Health Graph API?

AM: I’ve been using RunKeeper and saving my personal data to the Health Graph for a long time. After I participated in my first DietBet, it was clear the two should integrate.

BD: How will the Health Graph platform benefit your business?

AM: Running and weight loss have a symbiotic relationship: Losing weight helps you improve your running time and running helps you burn calories and lose weight. Players who connect with RunKeeper will be able to send weight updates and running activities directly into their DietBet game. Also, any weight updates made on DietBet will be saved back to the player’s Health Graph account.

BD: Which portions of the Health Graph API do you use, and why?

AM: Since DietBet players are required to submit their weight in order to play the game, we wanted to allow them to do this from both DietBet and RunKeeper. We are using Weight Measurements to get/post all of the weight data. We are also grabbing running details from Fitness Activities, so other players can see the hard work being done to help a player make their 4% goal.

DietBet screenshot

BD: What do you like about the Health Graph API?

AM: We love the simple approach to tracking changes using Root Resource and Change Log. This lowers the overhead on our end and lets us post activities and weight updates within minutes.

BD: If you could request any new feature from the Health Graph platform, what would it be? How would you use it?

AM: Most weight data is inputted manually using the honor code. Because we have a team of referees and a photo-based verification solution, we’d like to be able to indicate when weight entries are “verified” vs “manual” the same way you can specify a “tracked” vs “manual” fitness entry.

BD: Can you share any future plans for DietBet? What’s coming next that people will be excited about?

AM: We’re hoping to expand beyond the current game (4% in 4 weeks) and allow users to play games with longer timelines and larger weight loss goals. We also want to reward players for maintaining their weight or establishing healthy habits.

BD: Is there anything else we should know about you or DietBet?

AM: Organize a game today and use promo code HEALTHGRAPH. If you get 8+ other players into the game, we’ll refund your bet!

Bill Day (@billday) is Platform Evangelist & PM for RunKeeper where he helps developers learn about and use the Health Graph platform.


Fitness in your blood

InsideTracker (@Inside_Tracker) is a blood marker based service that provides a Health Graph (@healthgraphapi) integrated dashboard for your body. Read on to learn how you can use the Inside Tracker service (click here to buy at a special discount) to better understand how to optimize your own health and wellness.

Bill Day: Please tell us about yourself and your work.

Gil Blander: I am the founder of Segterra, the company that created InsideTracker, the most advanced blood analysis program.

InsideTracker is an innovative, web-based platform that combines blood analysis with your demographic information and unique goals to create a roadmap to optimal wellness and performance. The program recommends simple and tangible interventions, such as changes in food, supplements, lifestyle, and exercise, to help our users achieve their goals.

BD: What is the “elevator pitch” for why someone should use InsideTracker?

GB: Our bodies are our most valued possessions. InsideTracker gives you information and tools to help you perform at your most efficient and optimal level every day.

A good analogy is taking your car in for service every 5000 miles. The technician runs the computer diagnostic and then tells you what you should do to keep your car running in the best condition possible.

Every 3-6 months, getting your blood drawn and analyzed by InsideTracker tells you the current state of your body. It’s like having a window inside yourself to see exactly how you are doing. That knowledge combined with InsideTracker’s recommendations for simple lifestyle and nutrition changes empowers you to keep your body in the best possible condition.

BD: How did you get started using the Health Graph API?

GB: Our team was looking for partners who shared our goal of giving customers control of their wellness and performance. We were really excited to have the opportunity to integrate with RunKeeper. We think that there can be important synergies between InsideTracker and other companies using the Health Graph platform.

BD: How is using the Health Graph platform benefiting your business?

GB: The Health Graph platform has an extensive community of users who want to track their fitness and performance. It’s a perfect fit for InsideTracker and for our customers.

BD: Which portions of the Health Graph API do you use, and why?

GB: Initially, we are using the Health Graph API to acquire up-to-date information from InsideTracker users via mobile apps. These apps are convenient for our customers, and the data we receive from them makes our analysis more timely.

BD: What do you like about the Health Graph? What would you like to see changed?

GB: The Health Graph platform is excellent because it integrates so many different products and applications. Our customers benefit from being able to share and track many aspects of their fitness and wellness data through Health Graph.

BD: If you could request any new feature from the Health Graph, what would it be? How would you use it?

GB: In fact, the Health Graph team has already responded to our request to extend the Health Graph API to represent measurements of the biomarkers analyzed by InsideTracker! We plan to explore future extensions to InsideTracker in which users will be able to share their analysis data using the Health Graph API.

BD: Can you share any future plans for InsideTracker? What’s coming next that your customers will be excited about? Does the Health Graph play a role in that, and if so, how?

GB: InsideTracker is planning to integrate data from wireless scales so that we can update our recommendations for nutrition and exercise daily based on a customer’s weight. The Health Graph API is essential for us to integrate these data.

BD: Is there anything else we should know about you or InsideTracker?

GB: If you are looking for a roadmap to wellness and performance, get InsideTracker. You will find out where you are, where you should be, and how to get there by making changes in lifestyle, exercise, and nutrition. We turn measurements into meaningful advice.

Bill Day (@billday) is Platform Evangelist for RunKeeper where he helps developers learn about and use the Health Graph.


Health Graph API additions

We’ve made several recent additions to the Health Graph API (@healthgraphapi) based upon partner feedback and requests.

Recently added fields include:

  • source – string added to Fitness Activities, Background Activities, Nutrition, Sleep, Diabetes Measurements, and Weight portions of the Health Graph API; this provides the name of the application that last modified the given activity or measurement; see documentation for details.
  • is_live – boolean added to Fitness Activities to indicate whether the activity is currently being tracked via RunKeeper Live; note that this field will report ‘false‘ until at least one GPS point for the Live activity is received (this should occur immediately upon beginning the Live activity, but may be delayed up to several seconds if it takes longer than normal for GPS hardware to acquire a sufficient GPS signal).
  • userID – integer added to each team member entry from Street Team GET /team response to allow developers to more easily access team member account details (assuming member has authorized the calling app).
  • past activities are now available in a summary form that is more conducive to bandwidth-constrained environments; search for ‘summary’ in the Fitness Activities docs to learn more.
  • blood markers – a number of additional markers have been added to the General Measurements portion of the Health Graph API; for the complete list of what’s now available, please refer to documentation for General Measurements and Diabetes portions of the API.

Please let us know if you have any questions about these API updates by leaving a comment here or on this Health Graph discussion group thread (click here to access).

Bill Day (@billday) is Platform Evangelist for RunKeeper where he helps developers learn about and use the Health Graph.


ShapeUp Club brings deep nutrition data to the Health Graph

ShapeUp Club (@shapeup_club), one of the top three teams from last month’s Health Hack Day in Stockholm, recently launched the integration of their popular calorie counter with the Health Graph (@healthgraphapi). Learn how users of RunKeeper, ShapeUp Club, and other Health Graph partner apps such as Withings (@withings) are all benefitting from the collaboration.

BD: Please tell us about yourself and ShapeUp Club.

ShapeUp Club: Hi! We are Tove and Martin, the founders of ShapeUp Club. We built the original ShapeUp Club app back in 2008 as a side project during our studies in computer science (Martin) and biomedicine (Tove). By combining our knowledge we created ShapeUp Club – an interactive calorie counter that you carry in your pocket. A winning concept when it comes to weight loss.

In the beginning we planned to run this project in parallel with work and school. But we realized pretty fast that wouldn’t work, ShapeUp Club demanded too much time. The hobby became our job (hurray!) and today we are a team of five people working fulltime on ShapeUp Club.

BD: What is the “elevator pitch” for why someone should use ShapeUp Club?

SC: ShapeUp Club is a calorie counter for iPhone, Android, and web. Get a personal weight loss plan, track nutrition, exercise, and weight. Get shaped up with ShapeUp Club now!

BD: Can you tell us a bit about your users? How many do you have? How active are they? What kinds of things do they do with ShapeUp Club?

SC: Our app has been downloaded more than 1.7 million times. We have achieved top 10 App Store-placements in countries all over the world. ShapeUp Club has more than 350,000 active users per month and we are growing with 5,000 new members a day.

Daily feedback from our users proves our concept: The average users loses about 9 lbs. We also have a lot of success stories about users who lost more than 100 lbs. (Wow!)

Based on body features (such as weight and height), age, and daily activity level, ShapeUp Club calculates a personal weight loss plan for each user. The user then follows this plan by tracking what they eat and how much they exercise every day. A color-coordinated calorie bar visually displays how many more or fewer calories the user should eat each day to reach their target weight. A yellow bar indicates you should keep eating (need more calories for your goal), a green bar indicates you’ve eaten the perfect amount for the day, and a red bar indicates you’ve eaten too much that day.

BD: How did you get started using the Health Graph API?

SC: We attended Health Hack Day in Stockholm in May. Bill Day from RunKeeper was there to present on the Health Graph platform and serve as a jury member at the hackathon. We had already heard a lot about the API, and were excited to try it out.

During the hack we created ShapeUp Club Challenge, which would let the ShapeUp Club users connect, compete, and compare progress with each other. The API was super easy to integrate with our code, and we managed to create an app ready for launch in just twenty-four hours. The achievement placed us third in the competition.

A few weeks after the hackathon and our first encounter with the Health Graph, we are proud to announce that ShapeUp Club is now connected to Health Graph! As a first step we are letting our users import their RunKeeper and Withings data into ShapeUp Club, as well as upload their nutrition information from ShapeUp Club into the Health Graph.

BD: How is using the Health Graph benefiting your business?

SC: The combination of ShapeUp Club (nutrition tracking), RunKeeper (exercise tracking), and Withings (weight tracking) is perfect for people who wish to lose weight. Nutrition, exercise, and weight are the three key values people consider when trying to lose weight. By making the tracking of these three factors friction free we believe we are one step closer to the creation of the perfect and sustainable weight loss service. Our users have asked for this possibility for some time now, and we are so happy to finally be able to provide them with this.

BD: Which portions of the Health Graph API do you use, and why?

SC: We are one of the first partners who will share deep, personalized nutrition information with the Health Graph. We are also letting our users access weight and exercise information from other apps as mentioned above.

BD: What do you like about the Health Graph? What would you like to see changed?

SC: The possibilities to very easily combine different services with your own service and health tool is perfect. The API is easy to use and fast to integrate. The only change we would like to see is more focus on the nutrition part of the Health Graph. There’s a lot of more information we could share with the Health Graph if some additional fields were included in the API.

BD: Can you share any future plans for ShapeUp Club? What’s coming next that your users will be excited about? Does the Health Graph play a role in that, and if so, how?

SC: We are planning integration and partnerships with other great Health Graph integrated services.

We also want to improve ShapeUp Club core features. Integration of social tools is a next step, bringing our users closer together, making it possible to interact, motivate, and share information with each other. We believe this will create a whole new weight loss experience. Challenges, recipes, and groups are other things we are planning.

BD: Is there anything else we should know about you or your application?

SC: If you are serious about losing weight, ShapeUp Club is the perfect tool to help. It’s knowledge, inspiration, and motivation in your pocket. Download ShapeUp Club now and join our fast growing community! For news and more information about us, check out our blog at http://blog.shapeupclub.com/.

Bill Day (@billday) is Platform Evangelist for RunKeeper where he helps developers learn about and use the Health Graph.


Weighty makes weight and fat percentage entry simple

Some of the best Health Graph (@healthgraphapi) partner apps are built to solve a developer’s own health and fitness issues. Case in point: Weighty, a free mobile app for quickly and easily tracking your weight and body fat percentage using the Health Graph. Weighty creator Frank Van Rest (@frankvanrest) talks about the problem he wanted to solve with his app, and how he went about creating it, below.

Bill Day: Please tell us about yourself and your work.

Frank Van Rest: I’m a Dutch mathematician who graduated in the summer of 2011. During my studies I founded a web development company. After graduation I was in need of a new goal, and getting a regular job wasn’t a great lookout after being an entrepreneur for eight years.

While traveling I decided to target doing a full Ironman triathlon in two years. I’ve always been a basketball player and couldn’t swim, so this was a challenge. But I’ve been in training for half a year now and am getting in quite good shape!

BD: What is the “elevator pitch” for why someone should use Weighty?

FVR: Weighty is a free iPhone app that makes it super easy to submit your weight and fat percentage to the Health Graph. Tracking your weight is a key step to effectively losing (or gaining) weight. I hope Weighty makes this easy and simple for everyone.

BD: How did you get started using the Health Graph API?

FVR: As I’ve gone about my triathlon training, I wanted to add my weight and fat percentage to the same place as my activities. This was previously only possible via the RunKeeper website, which is not as easily accessible as a mobile app when I’m standing on my weight scale.

The Health Graph API made it easy for me to create such a mobile app myself! I started with the iOS library I found on github and got it (after some debugging) to working pretty quickly. (Editor’s note: A complete listing of available third-party Health Graph libraries is available by clicking here.)

BD: How is using the Health Graph benefiting you?

FVR: The Health Graph makes it easy to create apps that submit data to a central health-related data repository. This cloud-based approach is very valuable for users, since combined analyses can be done. RunKeeper provides free publicity for my app by highlighting it in the Health Graph app directory and showing it in users’ FitnessFeeds when they submit their weight or fat percentage to the Health Graph.

BD: Which portions of the Health Graph API do you use, and why?

FVR: After authentication, I only use the API calls to POST weight and fat percentage. In the future I want to add historical data to the app, at which point I’ll also use GET calls to read that data back from the Health Graph.

BD: What do you like about the Health Graph? What would you like to see changed?

FVR: I like the ease of use of the API. I got a working version up and ready to test in a few hours of work.

During testing I found some small bugs in the API, but the API team fixed it quickly after contact. I’d like additional capabilities to remove and edit data records as well.

BD: If you could request any new feature from the Health Graph, what would it be? How would you use it?

FVR: My scale also gives water percentage and muscle percentage, which I would love to keep track of as well. If that were possible with the Health Graph as well, I’d implement in Weighty!

BD: Can you share any future plans for Weighty? What’s coming next that your users will be excited about? Does the Health Graph play a role in that, and if so, how?

FVR: Removing or editing weight or fat percentage records is not possible at the moment (not on the RunKeeper website and not via the Health Graph API). If a user makes a typo and enters the wrong data, it can really mess up their graphs and weekly averages. I would love to have the ability to remove records via my app (or the website). As soon as that’s possible, I’ll add historical data to the app, with the possibility to edit and delete that data as well.

BD: Is there anything else we should know about you or your application?

FVR: It’s a free iPhone app called Weighty and it’s available via http://weighty.frisb.nl. Please share your feedback via email to weighty@frisb.nl.

Bill Day (@billday) is Platform Evangelist for RunKeeper where he helps developers learn about and use the Health Graph.


Gym Hero makes tracking workouts easy with the Health Graph

In honor of our participation in Health Hack Day (@healthhackday) in Stockholm later this week (watch this space for slides and more details), I’d like to feature some European Health Graph (@healthgraphapi) partners over the next couple of weeks. This time, let’s look at how one of our newest strength training partners, Berlin-based Gym Hero (@gymheroapp), is using a streamlined approach to workout tracking coupled with the Health Graph to help people improve their fitness.

Bill Day: Please tell us about yourself and your work.

Gym Hero: We are Jannik and Jannis, the founders of Big Mike Alright, the small but nice company behind Gym Hero. Gym Hero is currently a side project we are working on in addition to our day jobs and college. We both love sports but are especially addicted to kitesurfing!

BD: What is the “elevator pitch” for why someone should use your app?

Gym Hero is a gym workout tracking app that learns from you while staying out of your way as much as possible. The user interface is streamlined and optimized to be used while you work out, even with shaky hands. Workout routines are automatically learned as you go, so you never have to enter a weight or name twice. You are free to name your workouts and exercises however you like – full flexibility instead of endless searching and browsing in predefined, fixed lists. Each of your workouts gets its own webpage (if you want) with all the details, so you can share, compare and discuss with friends.

BD: How did you get started using the Health Graph API?

We both have been using Runkeeper tracking for our cardio activities for quite some time now. Being data and statistics junkies, our weight goes into the Health Graph via a Withings scale, and our blood pressure is monitored and sent to the Health Graph via a Withings blood pressure monitor. We track our runs and the bicycle commute to work with RunKeeper.

Because we also love to work out we wanted to add our gym workouts to our Runkeeper profile as well. When we heard about the Health Graph API we wanted to join. Quantify yourself!

BD: How is using the Health Graph benefiting Gym Hero and your users?

The Health Graph community is a place where sports enthusiasts of all types meet to motivate each other, exchange, discuss and most of all track and measure their performance. It’s a great place to collect all your sports and health related data. So obviously, we wanted to allow our community to join the Health Graph family and vice versa.

And for the programmers reading this: The Health Graph really is easy to use and embed into your applications. Go try it out!

BD: Which portions of the Health Graph API do you use, and why?

Since Gym Hero focuses on doing one thing only, but doing it really well, we use the strength training portion of the Health Graph API. We feed full workouts including workout notes and exercise names into the Health Graph. We don’t track cardio or time based training (yet).

BD: What do you like about the Health Graph? What would you like to see changed?

We love the idea behind the Health Graph. Bringing together such a great variety of health data is simply awesome. On top of that it’s a breeze to integrate into other applications. Just keep up the great work!

BD: If you could request any new feature from the Health Graph, what would it be? How would you use it?

We would like to see a little more flexibility when it comes to defining muscle groups for each exercise. Our basic idea for Gym Hero is to give our users full freedom in naming their exercises/workouts. We would love for this to also be possible for muscle grouping.

BD: Can you share any future plans for your app? What’s coming next that your users will be excited about? Does the Health Graph play a role in that, and if so, how?

We’ve been updating every five to six weeks with new features and improvements, but there are a lot of updates still to come. We will extend the workout summary view for a better performance check, add data sync with iCloud and a workout timer to name only a few upcoming features.

Our users can also request and vote for new features. They can do this by clicking on the speech bubble in the app or by going here. Please help us build the finest workout app ever by making your requests. We love to hear from our users!

BD: Is there anything else we should know about you or your application?

If you want to track your gym activities and are looking for a slick app which is not blown up with useless stuff check out Gym Hero. Never leave without flexing!

Bill Day (@billday) is Platform Evangelist for RunKeeper where he helps developers learn about and use the Health Graph.


Follow

Get every new post delivered to your Inbox.

Join 1,335 other followers