Guides

Welcome
Authentication
OAuth 2.0
OAuth 1.0
3-Legged OAuth
Data Types
Storable Data
Error Codes
Localization*

Method Overview
Foods
food.find_id_for_barcode*
food.get.v2
food.get (deprecated)
foods.autocomplete*
foods.search.v2*
foods.search
Food Brands
food_brands.get*
Food Categories
food_categories.get*
Food Sub Categories
food_sub_categories.get*
Recipes
recipe.get.v2
recipe.get
recipes.search.v3
recipes.search.v2
recipes.search
Recipe Types
recipe_types.get.v2
recipe_types.get

API Method Reference (OAuth 1.0)

Method Overview
Foods
food.add_favorite
food.create.v2*
food.create* (deprecated)
food.delete_favorite
food.find_id_for_barcode*
food.get.v2
food.get (deprecated)
foods.autocomplete*
foods.get_favorites
foods.get_most_eaten
foods.get_recently_eaten
foods.search.v2*
foods.search
Food Brands
food_brands.get*
Food Categories
food_categories.get*
Food Sub Categories
food_sub_categories.get*
Recipes
recipe.add_favorite
recipe.delete_favorite
recipe.get.v2
recipe.get
recipes.get_favorites
recipes.search.v3
recipes.search.v2
recipes.search
Recipe Types
recipe_types.get.v2
recipe_types.get
Saved Meals
saved_meal.create
saved_meal.delete
saved_meal.edit
saved_meals.get
saved_meal_item.add
saved_meal_item.delete
saved_meal_item.edit
saved_meal_items.get
Exercises
exercises.get
Profile - Management
profile.create
profile.get
profile.get_auth
Profile - Food Diary
food_entries.copy
food_entries.copy_saved_meal
food_entries.get
food_entries.get_month
food_entry.create
food_entry.delete
food_entry.edit
Profile - Exercise Diary
exercise_entries.commit_day
exercise_entries.get
exercise_entries.get_month
exercise_entries.save_template
exercise_entry.edit
Profile - Weight Diary
weight.update
weights.get_month

* denotes methods only available at the PREMIER level

Developers

REST API

Guides: Localization

Localization

Localization is a premium feature only made available to select accounts for specific languages and regions. Accounts with access to this feature are able to nominate locale information when executing particular REST API methods.

Localization is currently available for the following REST API methods:

OAuth 2.0

OAuth 1.0

Responses for these methods are localized by specifying an additional parameter named region. While each "region" has a default "language" (as specified in the Complete List of Regions below), unique combinations of region and language can be acheived by adding a further parameter named language.

Thus the options for localizing responses are as follows:

Specify neither region nor language:
The response will default to the "US" (United States) region and "en" (English) language.
Specify the region only:
The response will be in the nominated region, using the region's default language.
For instance, if the region "NL" (Netherlands) is specified, the language will default to "nl" (Dutch).
Specify both the region and language:
The response will be in the nominated region and the nominated language.

Parameters

region (String)

A value as specified in the Complete List of Regions below. Where specified, results will be filtered to foods/products available in the region. E.G.: "FR" returns results from France.

language (String)

A value as specified in the Complete List of Languages below. Where specified, names and expressions in API method responses will be in the specified language. E.G.: "fr" returns results in French.

Note: The language parameter is ignored unless region is also specified.

Note: foods.autocomplete* only works for the default region / language combination.

Complete List of Regions

Code	Region	Default Language
AF	Afghanistan	English
AL	Albania	English
DZ	Algeria	Arabic
AS	American Samoa	English
AD	Andorra	English
AO	Angola	Portuguese
AG	Antigua and Barbuda	English
AR	Argentina	Spanish
AM	Armenia	English
AW	Aruba	English
AU	Australia	English (Regional)
AT	Austria	German
AZ	Azerbaijan	English
BS	Bahamas	English
BH	Bahrain	Arabic
BD	Bangladesh	English
BB	Barbados	English
BY	Belarus	Russian
BE	Belgium	Dutch
BZ	Belize	English
BJ	Benin	English
BM	Bermuda	English
BT	Bhutan	English
BO	Bolivia	Spanish
BA	Bosnia and Herzegovina	English
BW	Botswana	English
BR	Brazil	Portuguese
BN	Brunei Darussalam	English
BG	Bulgaria	English
BF	Burkina Faso	French
BI	Burundi	English
KH	Cambodia	English
CM	Cameroon	French
CA	Canada	English (Canada)
CV	Cape Verde	English
KY	Cayman Islands	English
CF	Central African Republic	English
TD	Chad	Arabic
CL	Chile	Spanish
CN	China	Chinese
CO	Colombia	Spanish
KM	Comoros	English
CG	Congo	English
CR	Costa Rica	Spanish
HR	Croatia	English
CU	Cuba	English
CY	Cyprus	English
CZ	Czech Republic	English
CD	Democratic Republic of the Congo	French
DK	Denmark	Danish
DJ	Djibouti	English
DM	Dominica	English
DO	Dominican Republic	Spanish
EC	Ecuador	Spanish
EG	Egypt	Arabic
SV	El Salvador	Spanish
GQ	Equatorial Guinea	Spanish
ER	Eritrea	Arabic
EE	Estonia	English
ET	Ethiopia	English
FO	Faroe Islands	English
FJ	Fiji	English
FI	Finland	Finnish
FR	France	French
GF	French Guiana	English
PF	French Polynesia	English
GA	Gabon	English
GM	Gambia	English
GE	Georgia	English
DE	Germany	German
GH	Ghana	English (Regional)
GR	Greece	English
GL	Greenland	English
GD	Grenada	English
GP	Guadeloupe	English
GU	Guam	English
GT	Guatemala	Spanish
GG	Guernsey	English
GN	Guinea	French
GW	Guinea-Bissau	English
GY	Guyana	English
HT	Haiti	English
HN	Honduras	Spanish
HK	Hong Kong	Chinese (Traditional)
HU	Hungary	English
IS	Iceland	English
IN	India	English (Regional)
ID	Indonesia	Indonesian
IE	Ireland	English (Regional)
IM	Isle of Man	English
IL	Israel	English
IT	Italy	Italian
CI	Ivory Coast	French
JM	Jamaica	English
JP	Japan	Japanese
JE	Jersey	English
JO	Jordan	Arabic
KZ	Kazakhstan	Russian
KE	Kenya	English (Regional)
KI	Kiribati	English
KR	Korea	Korean
KW	Kuwait	Arabic
KG	Kyrgyzstan	English
LA	Laos	English
LV	Latvia	English
LB	Lebanon	Arabic
LS	Lesotho	English
LR	Liberia	English
LY	Libya	Arabic
LI	Liechtenstein	English
LT	Lithuania	English
LU	Luxembourg	English
MO	Macau	Chinese (Traditional)
MK	Macedonia	English
MG	Madagascar	French
MW	Malawi	English (Regional)
MY	Malaysia	English
MV	Maldives	English
ML	Mali	French
MT	Malta	English
MH	Marshall Islands	English
MQ	Martinique	English
MR	Mauritania	English
MU	Mauritius	English
YT	Mayotte	English
MX	Mexico	Spanish
FM	Micronesia	English
MD	Moldova	English
MC	Monaco	English
MN	Mongolia	English
ME	Montenegro	English
MA	Morocco	Arabic
MZ	Mozambique	Portuguese
MM	Myanmar	English
NA	Namibia	English
NP	Nepal	English
NL	Netherlands	Dutch
AN	Netherlands Antilles	English
NC	New Caledonia	English
NZ	New Zealand	English (Regional)
NI	Nicaragua	Spanish
NE	Niger	French
NG	Nigeria	English (Regional)
MP	Northern Mariana Islands	English
NO	Norway	Norwegian
OM	Oman	Arabic
PK	Pakistan	English (Regional)
PA	Panama	Spanish
PG	Papua New Guinea	English (Regional)
PY	Paraguay	Spanish
PE	Peru	Spanish
PH	Philippines	English (Regional)
PL	Poland	Polish
PT	Portugal	Portuguese (Portugal)
PR	Puerto Rico	Spanish
QA	Qatar	Arabic
RE	Reunion	English
RO	Romania	English
RU	Russia	Russian
RW	Rwanda	English (Regional)
KN	Saint Kitts and Nevis	English
LC	Saint Lucia	English
MF	Saint Martin	English
VC	Saint Vincent and The Grenadines	English
WS	Samoa	English
SM	San Marino	English
ST	Sao Tome and Principe	English
SA	Saudi Arabia	Arabic
SN	Senegal	French
RS	Serbia	English
SC	Seychelles	English
SL	Sierra Leone	English
SG	Singapore	English (Regional)
SK	Slovakia	English
SI	Slovenia	English
SB	Solomon Islands	English
SO	Somalia	Arabic
ZA	South Africa	English (Regional)
ES	Spain	Spanish
LK	Sri Lanka	English
SR	Suriname	English
SZ	Swaziland	English
SE	Sweden	Swedish
CH	Switzerland	German
SY	Syria	Arabic
TW	Taiwan	Chinese (Traditional)
TJ	Tajikistan	English
TZ	Tanzania	English (Regional)
TH	Thailand	English
TL	Timor-leste	English
TG	Togo	English
TO	Tonga	English
TT	Trinidad and Tobago	English
TN	Tunisia	Arabic
TR	Turkey	Turkish
TM	Turkmenistan	English
TC	Turks and Caicos Islands	English
UG	Uganda	English (Regional)
UA	Ukraine	Russian
AE	United Arab Emirates	Arabic
GB	United Kingdom	English (Regional)
US	United States	English
UY	Uruguay	Spanish
UZ	Uzbekistan	English
VU	Vanuatu	English
VE	Venezuela	Spanish
VN	Vietnam	English
VI	Virgin Islands, U.S.	English
EH	Western Sahara	English
YE	Yemen	Arabic
ZM	Zambia	English (Regional)
ZW	Zimbabwe	English (Regional)

Complete List of Languages

Code	Language
ar	Arabic
zh	Chinese
zh-TW	Chinese (Traditional)
da	Danish
nl	Dutch
en	English
en-CA	English (Canada)
en-UK	English (Regional)
fi	Finnish
fr	French
de	German
id	Indonesian
it	Italian
ja	Japanese
ko	Korean
nb	Norwegian
pl	Polish
pt	Portuguese
pt-PT	Portuguese (Portugal)
ru	Russian
es	Spanish
sv	Swedish
tr	Turkish